@jmruthers/pace-core 0.2.7 → 0.4.1

package/docs/api/modules.md

@@ -1,6 +1,6 @@
-[@jmruthers/pace-core - v0.2.7](README.md) / Exports
+[@jmruthers/pace-core - v0.4.01](README.md) / Exports
 
-# @jmruthers/pace-core - v0.2.7
+# @jmruthers/pace-core - v0.4.01
 
 **`File`**
 
@@ -32,7 +32,6 @@ import { Dialog, NavigationMenu } from '@jmruthers/pace-core/components';
 ### Classes
 
 - [ErrorBoundary](classes/ErrorBoundary.md)
-- [PublicErrorBoundary](classes/PublicErrorBoundary.md)
 
 ### Interfaces
 
@@ -44,9 +43,7 @@ import { Dialog, NavigationMenu } from '@jmruthers/pace-core/components';
 - [DataTableToolbarButton](interfaces/DataTableToolbarButton.md)
 - [AggregateConfig](interfaces/AggregateConfig.md)
 - [EmptyStateConfig](interfaces/EmptyStateConfig.md)
-- [FileUploadProps](interfaces/FileUploadProps.md)
 - [FooterProps](interfaces/FooterProps.md)
-- [InactivityWarningModalProps](interfaces/InactivityWarningModalProps.md)
 - [InputProps](interfaces/InputProps.md)
 - [LabelProps](interfaces/LabelProps.md)
 - [LoginFormProps](interfaces/LoginFormProps.md)
@@ -54,23 +51,9 @@ import { Dialog, NavigationMenu } from '@jmruthers/pace-core/components';
 - [NavigationMenuProps](interfaces/NavigationMenuProps.md)
 - [PaceAppLayoutProps](interfaces/PaceAppLayoutProps.md)
 - [PaceLoginPageProps](interfaces/PaceLoginPageProps.md)
-- [EventLogoProps](interfaces/EventLogoProps.md)
-- [PublicErrorBoundaryProps](interfaces/PublicErrorBoundaryProps.md)
-- [PublicErrorBoundaryState](interfaces/PublicErrorBoundaryState.md)
-- [PublicLoadingSpinnerProps](interfaces/PublicLoadingSpinnerProps.md)
-- [PublicPageFooterProps](interfaces/PublicPageFooterProps.md)
-- [PublicPageHeaderProps](interfaces/PublicPageHeaderProps.md)
-- [PublicPageLayoutProps](interfaces/PublicPageLayoutProps.md)
 - [ToastProps](interfaces/ToastProps.md)
 - [ToastActionElement](interfaces/ToastActionElement.md)
 - [UserMenuProps](interfaces/UserMenuProps.md)
-- [UsePublicEventReturn](interfaces/UsePublicEventReturn.md)
-- [UsePublicEventOptions](interfaces/UsePublicEventOptions.md)
-- [UsePublicEventLogoReturn](interfaces/UsePublicEventLogoReturn.md)
-- [UsePublicEventLogoOptions](interfaces/UsePublicEventLogoOptions.md)
-- [UsePublicRouteParamsReturn](interfaces/UsePublicRouteParamsReturn.md)
-- [UseInactivityTrackerOptions](interfaces/UseInactivityTrackerOptions.md)
-- [UseInactivityTrackerReturn](interfaces/UseInactivityTrackerReturn.md)
 - [EventContextType](interfaces/EventContextType.md)
 - [EventProviderProps](interfaces/EventProviderProps.md)
 - [UserEventAccess](interfaces/UserEventAccess.md)
@@ -86,15 +69,6 @@ import { Dialog, NavigationMenu } from '@jmruthers/pace-core/components';
 - [OrganisationSecurityError](interfaces/OrganisationSecurityError.md)
 - [OrganisationContextType](interfaces/OrganisationContextType.md)
 - [OrganisationProviderProps](interfaces/OrganisationProviderProps.md)
-- [StorageUploadOptions](interfaces/StorageUploadOptions.md)
-- [StorageFileMetadata](interfaces/StorageFileMetadata.md)
-- [StorageUploadResult](interfaces/StorageUploadResult.md)
-- [StorageUrlOptions](interfaces/StorageUrlOptions.md)
-- [StorageListOptions](interfaces/StorageListOptions.md)
-- [StorageFileInfo](interfaces/StorageFileInfo.md)
-- [StorageListResult](interfaces/StorageListResult.md)
-- [FileSizeLimits](interfaces/FileSizeLimits.md)
-- [StorageConfig](interfaces/StorageConfig.md)
 
 ### Type Aliases
 
@@ -104,10 +78,6 @@ import { Dialog, NavigationMenu } from '@jmruthers/pace-core/components';
 ### Variables
 
 - [styleConfig](modules.md#styleconfig)
-- [FILE\_SIZE\_LIMITS](modules.md#file_size_limits)
-- [DEFAULT\_FILE\_SIZE\_LIMIT](modules.md#default_file_size_limit)
-- [APP\_PATH\_MAPPING](modules.md#app_path_mapping)
-- [STORAGE\_CONFIG](modules.md#storage_config)
 
 ### Functions
 
@@ -138,12 +108,25 @@ import { Dialog, NavigationMenu } from '@jmruthers/pace-core/components';
 - [DialogFooter](modules.md#dialogfooter)
 - [DialogTitle](modules.md#dialogtitle)
 - [DialogDescription](modules.md#dialogdescription)
+- [DropdownMenu](modules.md#dropdownmenu)
+- [DropdownMenuTrigger](modules.md#dropdownmenutrigger)
+- [DropdownMenuGroup](modules.md#dropdownmenugroup)
+- [DropdownMenuPortal](modules.md#dropdownmenuportal)
+- [DropdownMenuSub](modules.md#dropdownmenusub)
+- [DropdownMenuRadioGroup](modules.md#dropdownmenuradiogroup)
+- [DropdownMenuSubTrigger](modules.md#dropdownmenusubtrigger)
+- [DropdownMenuSubContent](modules.md#dropdownmenusubcontent)
+- [DropdownMenuContent](modules.md#dropdownmenucontent)
+- [DropdownMenuItem](modules.md#dropdownmenuitem)
+- [DropdownMenuCheckboxItem](modules.md#dropdownmenucheckboxitem)
+- [DropdownMenuRadioItem](modules.md#dropdownmenuradioitem)
+- [DropdownMenuLabel](modules.md#dropdownmenulabel)
+- [DropdownMenuSeparator](modules.md#dropdownmenuseparator)
+- [DropdownMenuShortcut](modules.md#dropdownmenushortcut)
 - [EventSelector](modules.md#eventselector)
-- [FileUpload](modules.md#fileupload)
 - [Footer](modules.md#footer)
 - [Form](modules.md#form)
 - [Header](modules.md#header)
-- [InactivityWarningModal](modules.md#inactivitywarningmodal)
 - [Input](modules.md#input)
 - [Label](modules.md#label)
 - [LoadingSpinner](modules.md#loadingspinner)
@@ -155,24 +138,6 @@ import { Dialog, NavigationMenu } from '@jmruthers/pace-core/components';
 - [PasswordChangeForm](modules.md#passwordchangeform)
 - [PasswordResetForm](modules.md#passwordresetform)
 - [Progress](modules.md#progress)
-- [EventLogo](modules.md#eventlogo)
-- [EventLogoCompact](modules.md#eventlogocompact)
-- [EventLogoLarge](modules.md#eventlogolarge)
-- [useErrorBoundary](modules.md#useerrorboundary)
-- [DefaultPublicErrorFallback](modules.md#defaultpublicerrorfallback)
-- [PublicLoadingSpinner](modules.md#publicloadingspinner)
-- [PublicLoadingSpinnerFullPage](modules.md#publicloadingspinnerfullpage)
-- [PublicLoadingSkeleton](modules.md#publicloadingskeleton)
-- [PublicPageContextChecker](modules.md#publicpagecontextchecker)
-- [PublicPageDebugger](modules.md#publicpagedebugger)
-- [PublicPageDiagnostic](modules.md#publicpagediagnostic)
-- [PublicPageFooter](modules.md#publicpagefooter)
-- [PublicPageHeader](modules.md#publicpageheader)
-- [PublicPageLayout](modules.md#publicpagelayout)
-- [usePublicPageContext](modules.md#usepublicpagecontext)
-- [PublicPageProvider](modules.md#publicpageprovider)
-- [usePublicPageProviderContext](modules.md#usepublicpageprovidercontext)
-- [useIsPublicPage](modules.md#useispublicpage)
 - [Select](modules.md#select)
 - [SelectTrigger](modules.md#selecttrigger)
 - [SelectValue](modules.md#selectvalue)
@@ -204,22 +169,9 @@ import { Dialog, NavigationMenu } from '@jmruthers/pace-core/components';
 - [TooltipContent](modules.md#tooltipcontent)
 - [Tooltip](modules.md#tooltip)
 - [UserMenu](modules.md#usermenu)
-- [usePublicEvent](modules.md#usepublicevent)
-- [clearPublicEventCache](modules.md#clearpubliceventcache)
-- [getPublicEventCacheStats](modules.md#getpubliceventcachestats)
-- [usePublicEventLogo](modules.md#usepubliceventlogo)
-- [clearPublicLogoCache](modules.md#clearpubliclogocache)
-- [getPublicLogoCacheStats](modules.md#getpubliclogocachestats)
-- [usePublicRouteParams](modules.md#usepublicrouteparams)
-- [usePublicEventCode](modules.md#usepubliceventcode)
-- [generatePublicRoutePath](modules.md#generatepublicroutepath)
-- [extractEventCodeFromPath](modules.md#extracteventcodefrompath)
 - [useAppConfig](modules.md#useappconfig)
-- [useInactivityTracker](modules.md#useinactivitytracker)
 - [useOrganisationPermissions](modules.md#useorganisationpermissions)
 - [useOrganisationSecurity](modules.md#useorganisationsecurity)
-- [useStorage](modules.md#usestorage)
-- [useFileUpload](modules.md#usefileupload)
 - [useEvents](modules.md#useevents)
 - [EventProvider](modules.md#eventprovider)
 - [OrganisationProvider](modules.md#organisationprovider)
@@ -239,18 +191,6 @@ import { Dialog, NavigationMenu } from '@jmruthers/pace-core/components';
 - [getCurrentAppId](modules.md#getcurrentappid)
 - [cn](modules.md#cn)
 - [createSecureDataAccess](modules.md#createsecuredataaccess)
-- [getFileSizeLimit](modules.md#getfilesizelimit)
-- [validateFileSize](modules.md#validatefilesize)
-- [formatFileSize](modules.md#formatfilesize)
-- [generateFilePath](modules.md#generatefilepath)
-- [generateUniqueFileName](modules.md#generateuniquefilename)
-- [extractFileMetadata](modules.md#extractfilemetadata)
-- [uploadFile](modules.md#uploadfile)
-- [getPublicUrl](modules.md#getpublicurl)
-- [getSignedUrl](modules.md#getsignedurl)
-- [deleteFile](modules.md#deletefile)
-- [listFiles](modules.md#listfiles)
-- [archiveFile](modules.md#archivefile)
 
 ## Type Aliases
 
@@ -307,62 +247,19 @@ Row identifier function type
 
 | Name | Type |
 | :------ | :------ |
-| `core` | \{ `path`: ``"./core.css"`` = './core.css'; `description`: ``"Complete CSS foundation including base styles, theme mappings, fonts, resets, and neutral tokens"`` = 'Complete CSS foundation including base styles, theme mappings, fonts, resets, and neutral tokens' } |
-| `core.path` | ``"./core.css"`` |
-| `core.description` | ``"Complete CSS foundation including base styles, theme mappings, fonts, resets, and neutral tokens"`` |
+| `base` | \{ `path`: ``"./base.css"`` = './base.css'; `description`: ``"Base styles, fonts, resets, and neutral tokens"`` = 'Base styles, fonts, resets, and neutral tokens' } |
+| `base.path` | ``"./base.css"`` |
+| `base.description` | ``"Base styles, fonts, resets, and neutral tokens"`` |
+| `theme` | \{ `path`: ``"./theme.css"`` = './theme.css'; `description`: ``"Theme mappings for native Tailwind utilities"`` = 'Theme mappings for native Tailwind utilities' } |
+| `theme.path` | ``"./theme.css"`` |
+| `theme.description` | ``"Theme mappings for native Tailwind utilities"`` |
+| `dark` | \{ `path`: ``"./dark.css"`` = './dark.css'; `description`: ``"Dark mode shade remap styles"`` = 'Dark mode shade remap styles' } |
+| `dark.path` | ``"./dark.css"`` |
+| `dark.description` | ``"Dark mode shade remap styles"`` |
 
 #### Defined in
 
-[packages/core/src/styles/index.ts:32](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/styles/index.ts#L32)
-
-___
-
-### FILE\_SIZE\_LIMITS
-
-• `Const` **FILE\_SIZE\_LIMITS**: [`FileSizeLimits`](interfaces/FileSizeLimits.md)
-
-File size limits by MIME type (in bytes)
-
-#### Defined in
-
-[packages/core/src/utils/storage/config.ts:10](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/utils/storage/config.ts#L10)
-
-___
-
-### DEFAULT\_FILE\_SIZE\_LIMIT
-
-• `Const` **DEFAULT\_FILE\_SIZE\_LIMIT**: `number`
-
-Default file size limit for unknown MIME types
-
-#### Defined in
-
-[packages/core/src/utils/storage/config.ts:38](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/utils/storage/config.ts#L38)
-
-___
-
-### APP\_PATH\_MAPPING
-
-• `Const` **APP\_PATH\_MAPPING**: `Record`\<`string`, `string`\>
-
-App-specific path mappings for file organization
-Maps app names to their primary category in the organization-first structure
-
-#### Defined in
-
-[packages/core/src/utils/storage/config.ts:44](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/utils/storage/config.ts#L44)
-
-___
-
-### STORAGE\_CONFIG
-
-• `Const` **STORAGE\_CONFIG**: [`StorageConfig`](interfaces/StorageConfig.md)
-
-Storage configuration
-
-#### Defined in
-
-[packages/core/src/utils/storage/config.ts:54](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/utils/storage/config.ts#L54)
+[packages/core/src/styles/index.ts:34](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/styles/index.ts#L34)
 
 ## Functions
 
@@ -614,7 +511,7 @@ ___
 
 | Name | Type |
 | :------ | :------ |
-| `props` | `HTMLAttributes`\<`HTMLElement`\> & `RefAttributes`\<`HTMLElement`\> |
+| `props` | `HTMLAttributes`\<`HTMLDivElement`\> & `RefAttributes`\<`HTMLDivElement`\> |
 
 #### Returns
 
@@ -654,7 +551,7 @@ ___
 
 | Name | Type |
 | :------ | :------ |
-| `props` | `HTMLAttributes`\<`HTMLParagraphElement`\> & `RefAttributes`\<`HTMLParagraphElement`\> |
+| `props` | `HTMLAttributes`\<`HTMLElement`\> & `RefAttributes`\<`HTMLElement`\> |
 
 #### Returns
 
@@ -688,17 +585,17 @@ ___
 
 ### DataTable
 
-▸ **DataTable**\<`TData`\>(`props`): `Element`
+▸ **DataTable**\<`TData`\>(`«destructured»`): `Element`
 
-Enhanced DataTable with comprehensive performance optimizations
+Enhanced DataTable with comprehensive performance optimizations and full backward compatibility
 
 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
+- < 1,000 records: Standard rendering with optional client-side features
+- 1,000 - 10,000 records: Client-side with virtual scrolling and chunking
+- 10,000 - 50,000 records: Hybrid mode with intelligent data management
+- > 50,000 records: Server-side processing with virtualization
 
-Features are configured through the unified `features` prop for maximum flexibility.
+All existing DataTable APIs remain fully compatible. Performance features are additive.
 
 #### Type parameters
 
@@ -710,7 +607,7 @@ Features are configured through the unified `features` prop for maximum flexibil
 
 | Name | Type |
 | :------ | :------ |
-| `props` | [`DataTableProps`](interfaces/DataTableProps.md)\<`TData`\> |
+| `«destructured»` | [`DataTableProps`](interfaces/DataTableProps.md)\<`TData`\> |
 
 #### Returns
 
@@ -718,7 +615,7 @@ Features are configured through the unified `features` prop for maximum flexibil
 
 #### Defined in
 
-[packages/core/src/components/DataTable/DataTable.tsx:412](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/DataTable/DataTable.tsx#L412)
+[packages/core/src/components/DataTable/DataTable.tsx:382](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/DataTable/DataTable.tsx#L382)
 
 ___
 
@@ -739,7 +636,7 @@ ___
 
 #### Defined in
 
-[packages/core/src/components/Dialog/Dialog.tsx:288](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Dialog/Dialog.tsx#L288)
+[packages/core/src/components/Dialog/Dialog.tsx:248](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Dialog/Dialog.tsx#L248)
 
 ___
 
@@ -759,7 +656,7 @@ ___
 
 #### Defined in
 
-[packages/core/src/components/Dialog/Dialog.tsx:289](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Dialog/Dialog.tsx#L289)
+[packages/core/src/components/Dialog/Dialog.tsx:249](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Dialog/Dialog.tsx#L249)
 
 ___
 
@@ -780,7 +677,7 @@ ___
 
 #### Defined in
 
-[packages/core/src/components/Dialog/Dialog.tsx:290](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Dialog/Dialog.tsx#L290)
+[packages/core/src/components/Dialog/Dialog.tsx:250](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Dialog/Dialog.tsx#L250)
 
 ___
 
@@ -800,7 +697,7 @@ ___
 
 #### Defined in
 
-[packages/core/src/components/Dialog/Dialog.tsx:291](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Dialog/Dialog.tsx#L291)
+[packages/core/src/components/Dialog/Dialog.tsx:251](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Dialog/Dialog.tsx#L251)
 
 ___
 
@@ -820,7 +717,7 @@ ___
 
 #### Defined in
 
-[packages/core/src/components/Dialog/Dialog.tsx:294](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Dialog/Dialog.tsx#L294)
+[packages/core/src/components/Dialog/Dialog.tsx:254](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Dialog/Dialog.tsx#L254)
 
 ___
 
@@ -863,7 +760,7 @@ JSX.Element - The semantic dialog content with overlay and optional close button
 
 #### Defined in
 
-[packages/core/src/components/Dialog/Dialog.tsx:437](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Dialog/Dialog.tsx#L437)
+[packages/core/src/components/Dialog/Dialog.tsx:397](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Dialog/Dialog.tsx#L397)
 
 ___
 
@@ -897,7 +794,7 @@ JSX.Element - The dialog header container using semantic <header> element
 
 #### Defined in
 
-[packages/core/src/components/Dialog/Dialog.tsx:555](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Dialog/Dialog.tsx#L555)
+[packages/core/src/components/Dialog/Dialog.tsx:517](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Dialog/Dialog.tsx#L517)
 
 ___
 
@@ -907,7 +804,6 @@ ___
 
 DialogBody component
 Semantic main content area for dialog body content with scrollable functionality
-Supports both React children and safe HTML content rendering
 
 #### Parameters
 
@@ -924,24 +820,17 @@ JSX.Element - The scrollable dialog body container using semantic <main> element
 **`Example`**
 
 ```tsx
-// Using React children
 <DialogBody>
   <section className="space-y-4">
     <h4>Content Title</h4>
     <p>Long content that will scroll...</p>
   </section>
 </DialogBody>
-
-// Using HTML content
-<DialogBody 
-  htmlContent="<h2>Import Instructions</h2><p>Upload a CSV file with the following format:</p><ul><li>Required columns: name, email</li><li>Optional columns: phone, address</li></ul>"
-  allowHtml={true}
-/>
 ```
 
 #### Defined in
 
-[packages/core/src/components/Dialog/Dialog.tsx:596](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Dialog/Dialog.tsx#L596)
+[packages/core/src/components/Dialog/Dialog.tsx:550](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Dialog/Dialog.tsx#L550)
 
 ___
 
@@ -975,7 +864,7 @@ JSX.Element - The dialog footer container using semantic <footer> element
 
 #### Defined in
 
-[packages/core/src/components/Dialog/Dialog.tsx:685](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Dialog/Dialog.tsx#L685)
+[packages/core/src/components/Dialog/Dialog.tsx:593](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Dialog/Dialog.tsx#L593)
 
 ___
 
@@ -995,7 +884,7 @@ ___
 
 #### Defined in
 
-[packages/core/src/components/Dialog/Dialog.tsx:701](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Dialog/Dialog.tsx#L701)
+[packages/core/src/components/Dialog/Dialog.tsx:609](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Dialog/Dialog.tsx#L609)
 
 ___
 
@@ -1015,78 +904,60 @@ ___
 
 #### Defined in
 
-[packages/core/src/components/Dialog/Dialog.tsx:737](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Dialog/Dialog.tsx#L737)
+[packages/core/src/components/Dialog/Dialog.tsx:624](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Dialog/Dialog.tsx#L624)
 
 ___
 
-### EventSelector
-
-▸ **EventSelector**(`«destructured»`): ``null`` \| `Element`
-
-EventSelector component for selecting events with built-in access control
+### DropdownMenu
 
-This component provides secure event selection with:
-- Database integration via rbac_event_app_roles table
-- Auto-selection of next upcoming event by date
-- Cross-device sync via Supabase user session metadata
-- localStorage fallback for offline scenarios
-- Comprehensive error handling and user feedback
+▸ **DropdownMenu**(`props`, `deprecatedLegacyContext?`): `ReactNode`
 
 #### Parameters
 
-| Name | Type |
-| :------ | :------ |
-| `«destructured»` | `EventSelectorProps` |
+| Name | Type | Description |
+| :------ | :------ | :------ |
+| `props` | `DropdownMenuProps` | - |
+| `deprecatedLegacyContext?` | `any` | **`See`** [React Docs](https://legacy.reactjs.org/docs/legacy-context.html#referencing-context-in-lifecycle-methods) |
 
 #### Returns
 
-``null`` \| `Element`
-
-**`Component`**
-
-**`Example`**
-
-```ts
-<UnifiedAuthProvider supabaseClient={supabase} appName="PACE">
-  <EventSelector onEventChange={(event) => console.log(event)} />
-</UnifiedAuthProvider>
-```
+`ReactNode`
 
 #### Defined in
 
-[packages/core/src/components/EventSelector/EventSelector.tsx:130](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/EventSelector/EventSelector.tsx#L130)
+[packages/core/src/components/DropdownMenu/DropdownMenu.tsx:114](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/DropdownMenu/DropdownMenu.tsx#L114)
 
 ___
 
-### FileUpload
+### DropdownMenuTrigger
 
-▸ **FileUpload**(`«destructured»`): `Element`
+▸ **DropdownMenuTrigger**(`props`): `ReactNode`
 
 #### Parameters
 
 | Name | Type |
 | :------ | :------ |
-| `«destructured»` | [`FileUploadProps`](interfaces/FileUploadProps.md) |
+| `props` | `DropdownMenuTriggerProps` & `RefAttributes`\<`HTMLButtonElement`\> |
 
 #### Returns
 
-`Element`
+`ReactNode`
 
 #### Defined in
 
-[packages/core/src/components/FileUpload/FileUpload.tsx:27](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/FileUpload/FileUpload.tsx#L27)
+[packages/core/src/components/DropdownMenu/DropdownMenu.tsx:116](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/DropdownMenu/DropdownMenu.tsx#L116)
 
 ___
 
-### Footer
+### DropdownMenuGroup
 
-▸ **Footer**(`props`): `ReactNode`
+▸ **DropdownMenuGroup**(`props`): `ReactNode`
 
 #### Parameters
 
 | Name | Type |
 | :------ | :------ |
-| `props` | [`FooterProps`](interfaces/FooterProps.md) |
+| `props` | `DropdownMenuGroupProps` & `RefAttributes`\<`HTMLDivElement`\> |
 
 #### Returns
 
@@ -1094,1107 +965,876 @@ ___
 
 #### Defined in
 
-[packages/core/src/components/Footer/Footer.tsx:196](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Footer/Footer.tsx#L196)
+[packages/core/src/components/DropdownMenu/DropdownMenu.tsx:118](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/DropdownMenu/DropdownMenu.tsx#L118)
 
 ___
 
-### Form
-
-▸ **Form**\<`TFieldValues`\>(`props`): `Element`
-
-Form component with validation and React Hook Form integration
-
-#### Type parameters
+### DropdownMenuPortal
 
-| Name | Type | Description |
-| :------ | :------ | :------ |
-| `TFieldValues` | extends `FieldValues` = `FieldValues` | The type of form field values |
+▸ **DropdownMenuPortal**(`props`, `deprecatedLegacyContext?`): `ReactNode`
 
 #### Parameters
 
 | Name | Type | Description |
 | :------ | :------ | :------ |
-| `props` | `FormProps`\<`TFieldValues`\> | Form configuration and handlers |
+| `props` | `DropdownMenuPortalProps` | - |
+| `deprecatedLegacyContext?` | `any` | **`See`** [React Docs](https://legacy.reactjs.org/docs/legacy-context.html#referencing-context-in-lifecycle-methods) |
 
 #### Returns
 
-`Element`
-
-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>
-```
+`ReactNode`
 
 #### Defined in
 
-[packages/core/src/components/Form/Form.tsx:142](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Form/Form.tsx#L142)
+[packages/core/src/components/DropdownMenu/DropdownMenu.tsx:120](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/DropdownMenu/DropdownMenu.tsx#L120)
 
 ___
 
-### Header
-
-▸ **Header**(`props`): `Element`
-
-Header component for application layouts with comprehensive navigation, user management, 
-and customizable branding support.
-
-A flexible header component that supports various configurations including custom logos,
-navigation menus, user authentication, event selection, and custom actions.
+### DropdownMenuSub
 
-Features:
-- Customizable logo (URL or custom component)
-- Navigation menu integration with highlighting
-- User menu with authentication and password management
-- Event selector for multi-tenant applications
-- Custom actions support
-- Responsive design with mobile considerations
-- Accessibility compliant with proper ARIA attributes
-- Backdrop blur effects for modern UI
-- Flexible layout with configurable sections
+▸ **DropdownMenuSub**(`props`, `deprecatedLegacyContext?`): `ReactNode`
 
 #### Parameters
 
 | Name | Type | Description |
 | :------ | :------ | :------ |
-| `props` | `HeaderProps` | Header configuration including logo, navigation, user settings, and custom content |
+| `props` | `DropdownMenuSubProps` | - |
+| `deprecatedLegacyContext?` | `any` | **`See`** [React Docs](https://legacy.reactjs.org/docs/legacy-context.html#referencing-context-in-lifecycle-methods) |
 
 #### Returns
 
-`Element`
-
-React element with complete header functionality
-
-**`Example`**
-
-Basic header with logo and navigation:
-```tsx
-import { Header } from '@jmruthers/pace-core';
-import { useNavigate, useLocation } from 'react-router-dom';
-
-function AppHeader() {
-  const navigate = useNavigate();
-  const location = useLocation();
-
-  const navItems = [
-    { id: 'dashboard', label: 'Dashboard', href: '/dashboard' },
-    { id: 'meals', label: 'Meals', href: '/meals' },
-    { id: 'settings', label: 'Settings', href: '/settings' }
-  ];
+`ReactNode`
 
-  return (
-    <Header
-      logoUrl="/company-logo.svg"
-      logoAlt="My Company"
-      navItems={navItems}
-      currentPath={location.pathname}
-      onNavigate={(item) => navigate(item.href)}
-      user={currentUser}
-      onSignOut={handleSignOut}
-    />
-  );
-}
-```
+#### Defined in
 
-**`Example`**
+[packages/core/src/components/DropdownMenu/DropdownMenu.tsx:122](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/DropdownMenu/DropdownMenu.tsx#L122)
 
-Header with custom actions:
-```tsx
-import { Header, Button } from '@jmruthers/pace-core';
+___
 
-function HeaderWithActions() {
-  const customActions = (
-    <div className="flex items-center gap-2">
-      <Button variant="outline" size="sm">Export</Button>
-      <Button size="sm">New Item</Button>
-    </div>
-  );
+### DropdownMenuRadioGroup
 
-  return (
-    <Header
-      logoUrl="/logo.svg"
-      navItems={navigationItems}
-      actions={customActions}
-      user={currentUser}
-      onSignOut={handleSignOut}
-    />
-  );
-}
-```
+▸ **DropdownMenuRadioGroup**(`props`): `ReactNode`
 
-**`Example`**
+#### Parameters
 
-Minimal header configuration:
-```tsx
-function MinimalHeader() {
-  return (
-    <Header
-      logoUrl="/simple-logo.svg"
-      logoAlt="Simple App"
-      showEventSelector={false}
-      user={currentUser}
-      onSignOut={handleSignOut}
-    />
-  );
-}
-```
+| Name | Type |
+| :------ | :------ |
+| `props` | `DropdownMenuRadioGroupProps` & `RefAttributes`\<`HTMLDivElement`\> |
 
-**`Since`**
+#### Returns
 
-0.1.0
+`ReactNode`
 
 #### Defined in
 
-[packages/core/src/components/Header/Header.tsx:219](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Header/Header.tsx#L219)
+[packages/core/src/components/DropdownMenu/DropdownMenu.tsx:124](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/DropdownMenu/DropdownMenu.tsx#L124)
 
 ___
 
-### InactivityWarningModal
+### DropdownMenuSubTrigger
 
-▸ **InactivityWarningModal**(`«destructured»`): `Element`
+▸ **DropdownMenuSubTrigger**(`props`): `ReactNode`
 
 #### Parameters
 
 | Name | Type |
 | :------ | :------ |
-| `«destructured»` | [`InactivityWarningModalProps`](interfaces/InactivityWarningModalProps.md) |
+| `props` | `Omit`\<`DropdownMenuSubTriggerProps` & `RefAttributes`\<`HTMLDivElement`\>, ``"ref"``\> & \{ `inset?`: `boolean`  } & `RefAttributes`\<`HTMLDivElement`\> |
 
 #### Returns
 
-`Element`
+`ReactNode`
 
 #### Defined in
 
-[packages/core/src/components/InactivityWarningModal/InactivityWarningModal.tsx:71](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/InactivityWarningModal/InactivityWarningModal.tsx#L71)
+[packages/core/src/components/DropdownMenu/DropdownMenu.tsx:126](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/DropdownMenu/DropdownMenu.tsx#L126)
 
 ___
 
-### Input
+### DropdownMenuSubContent
 
-▸ **Input**(`props`): `ReactNode`
+▸ **DropdownMenuSubContent**(`props`): `ReactNode`
 
-Input component
-A flexible, accessible input component with multiple variants and sizes
+DropdownMenuSubContent component
+The content container for dropdown menu sub-items
 
 #### Parameters
 
 | Name | Type | Description |
 | :------ | :------ | :------ |
-| `props` | [`InputProps`](interfaces/InputProps.md) & `RefAttributes`\<`HTMLInputElement`\> | Input configuration and styling |
+| `props` | `Omit`\<`DropdownMenuSubContentProps` & `RefAttributes`\<`HTMLDivElement`\>, ``"ref"``\> & `RefAttributes`\<`HTMLDivElement`\> | Content configuration and styling |
 
 #### Returns
 
 `ReactNode`
 
-JSX.Element - The rendered input element
+JSX.Element - The dropdown menu sub-content container
 
 **`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" 
-/>
+<DropdownMenuSubContent>
+  <DropdownMenuItem>Option 1</DropdownMenuItem>
+  <DropdownMenuItem>Option 2</DropdownMenuItem>
+</DropdownMenuSubContent>
 ```
 
 #### Defined in
 
-[packages/core/src/components/Input/Input.tsx:104](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Input/Input.tsx#L104)
+[packages/core/src/components/DropdownMenu/DropdownMenu.tsx:163](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/DropdownMenu/DropdownMenu.tsx#L163)
 
 ___
 
-### Label
+### DropdownMenuContent
 
-▸ **Label**(`props`): `ReactNode`
+▸ **DropdownMenuContent**(`props`): `ReactNode`
 
-Label component
-An accessible label with helper text and error state support
+DropdownMenuContent component
+The main content container for dropdown menu items
 
 #### Parameters
 
 | Name | Type | Description |
 | :------ | :------ | :------ |
-| `props` | [`LabelProps`](interfaces/LabelProps.md) & `RefAttributes`\<`HTMLLabelElement`\> | Label configuration and styling |
+| `props` | `Omit`\<`DropdownMenuContentProps` & `RefAttributes`\<`HTMLDivElement`\>, ``"ref"``\> & `RefAttributes`\<`HTMLDivElement`\> | Content configuration and styling |
 
 #### Returns
 
 `ReactNode`
 
-JSX.Element - The rendered label with optional helper text and errors
+JSX.Element - The dropdown menu content container
 
 **`Example`**
 
 ```tsx
-<Label htmlFor="email" required helperText="We'll never share your email">
-  Email Address
-</Label>
+<DropdownMenuContent>
+  <DropdownMenuItem>Profile</DropdownMenuItem>
+  <DropdownMenuItem>Settings</DropdownMenuItem>
+</DropdownMenuContent>
 ```
 
 #### Defined in
 
-[packages/core/src/components/Label/Label.tsx:120](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Label/Label.tsx#L120)
+[packages/core/src/components/DropdownMenu/DropdownMenu.tsx:194](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/DropdownMenu/DropdownMenu.tsx#L194)
 
 ___
 
-### LoadingSpinner
+### DropdownMenuItem
 
-▸ **LoadingSpinner**(`props`, `deprecatedLegacyContext?`): `ReactNode`
+▸ **DropdownMenuItem**(`props`): `ReactNode`
 
-LoadingSpinner component
-A simple, accessible loading spinner for indicating loading states
+DropdownMenuItem component
+Individual menu item within the dropdown
 
 #### Parameters
 
 | Name | Type | Description |
 | :------ | :------ | :------ |
-| `props` | `LoadingSpinnerProps` | Spinner configuration and styling |
-| `deprecatedLegacyContext?` | `any` | **`See`** [React Docs](https://legacy.reactjs.org/docs/legacy-context.html#referencing-context-in-lifecycle-methods) |
+| `props` | `Omit`\<`DropdownMenuItemProps` & `RefAttributes`\<`HTMLDivElement`\>, ``"ref"``\> & \{ `inset?`: `boolean`  } & `RefAttributes`\<`HTMLDivElement`\> | Item configuration and styling |
 
 #### Returns
 
 `ReactNode`
 
-JSX.Element - The rendered loading spinner
+JSX.Element - The dropdown menu item
 
 **`Example`**
 
 ```tsx
-<LoadingSpinner size="lg" className="text-main-500" />
+<DropdownMenuItem onClick={() => console.log('clicked')}>
+  Profile
+</DropdownMenuItem>
 ```
 
 #### Defined in
 
-[packages/core/src/components/LoadingSpinner/LoadingSpinner.tsx:83](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/LoadingSpinner/LoadingSpinner.tsx#L83)
+[packages/core/src/components/DropdownMenu/DropdownMenu.tsx:227](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/DropdownMenu/DropdownMenu.tsx#L227)
 
 ___
 
-### LoginForm
-
-▸ **LoginForm**(`props`): `ReactNode`
+### DropdownMenuCheckboxItem
 
-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.
+▸ **DropdownMenuCheckboxItem**(`props`): `ReactNode`
 
 #### Parameters
 
-| Name | Type | Description |
-| :------ | :------ | :------ |
-| `props` | [`LoginFormProps`](interfaces/LoginFormProps.md) | Login form configuration and handlers |
+| Name | Type |
+| :------ | :------ |
+| `props` | `Omit`\<`DropdownMenuCheckboxItemProps` & `RefAttributes`\<`HTMLDivElement`\>, ``"ref"``\> & `RefAttributes`\<`HTMLDivElement`\> |
 
 #### Returns
 
 `ReactNode`
 
-JSX.Element - The rendered login form
-
-**`Example`**
-
-```tsx
-<LoginForm
-  onSignIn={handleSignIn}
-  onSuccess={() => navigate('/dashboard')}
-  onError={(error) => toast.error(error.message)}
-  isLoading={isAuthenticating}
-/>
-```
-
 #### Defined in
 
-[packages/core/src/components/LoginForm/LoginForm.tsx:150](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/LoginForm/LoginForm.tsx#L150)
+[packages/core/src/components/DropdownMenu/DropdownMenu.tsx:245](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/DropdownMenu/DropdownMenu.tsx#L245)
 
 ___
 
-### NavigationMenu
-
-▸ **NavigationMenu**(`props`): `ReactNode`
-
-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.
+### DropdownMenuRadioItem
 
-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)
+▸ **DropdownMenuRadioItem**(`props`): `ReactNode`
 
 #### Parameters
 
-| Name | Type | Description |
-| :------ | :------ | :------ |
-| `props` | [`NavigationMenuProps`](interfaces/NavigationMenuProps.md) & `RefAttributes`\<`HTMLDivElement`\> | NavigationMenu component props including items, mode, navigation handlers, and styling options |
+| Name | Type |
+| :------ | :------ |
+| `props` | `Omit`\<`DropdownMenuRadioItemProps` & `RefAttributes`\<`HTMLDivElement`\>, ``"ref"``\> & `RefAttributes`\<`HTMLDivElement`\> |
 
 #### Returns
 
 `ReactNode`
 
-React element with navigation menu functionality
-
-**`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' }
-  ];
+#### Defined in
 
-  return (
-    <NavigationMenu 
-      items={navItems}
-      mode="dropdown"
-      currentPath={location.pathname}
-      onNavigate={(item) => navigate(item.href)}
-      buttonText="Main Menu"
-      showIcons={true}
-    />
-  );
-}
-```
+[packages/core/src/components/DropdownMenu/DropdownMenu.tsx:268](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/DropdownMenu/DropdownMenu.tsx#L268)
 
-**`Example`**
+___
 
-Hierarchical navigation with nested items:
-```tsx
-import { NavigationMenu } from '@jmruthers/pace-core';
+### DropdownMenuLabel
 
-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' }
-  ];
+▸ **DropdownMenuLabel**(`props`): `ReactNode`
 
-  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"
-    />
-  );
-}
-```
+#### Parameters
 
-**`Example`**
+| Name | Type |
+| :------ | :------ |
+| `props` | `Omit`\<`DropdownMenuLabelProps` & `RefAttributes`\<`HTMLDivElement`\>, ``"ref"``\> & \{ `inset?`: `boolean`  } & `RefAttributes`\<`HTMLDivElement`\> |
 
-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';
+#### Returns
 
-function AuthenticatedNavigation() {
-  const navigate = useNavigate();
-  const location = useLocation();
-  const { hasRole, hasPermission } = useUnifiedAuth();
+`ReactNode`
 
-  // 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'
-    }
-  ];
+#### Defined in
 
-  return (
-    <NavigationMenu 
-      items={navItems}
-      mode="dropdown"
-      currentPath={location.pathname}
-      onNavigate={(item) => navigate(item.href)}
-      buttonText="Navigation"
-      navigationLabel="Main application navigation"
-      filterByPermissions={true}
-      auditLog={true}
-    />
-  );
-}
-```
+[packages/core/src/components/DropdownMenu/DropdownMenu.tsx:290](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/DropdownMenu/DropdownMenu.tsx#L290)
 
-**`Example`**
+___
 
-Custom navigation with external links and actions:
-```tsx
-import { NavigationMenu } from '@jmruthers/pace-core';
+### DropdownMenuSeparator
 
-function CustomNavigation() {
-  const handleNavigation = (item) => {
-    if (item.id === 'logout') {
-      // Handle logout action
-      handleLogout();
-    } else if (item.href?.startsWith('http')) {
-      // Handle external links
-      window.open(item.href, '_blank');
-    } else if (item.href) {
-      // Handle internal navigation
-      navigate(item.href);
-    }
-  };
+▸ **DropdownMenuSeparator**(`props`): `ReactNode`
 
-  const navItems = [
-    { id: 'home', label: 'Home', href: '/', icon: 'Home' },
-    { id: 'help', label: 'Help Center', href: 'https://help.example.com', icon: 'HelpCircle' },
-    { id: 'logout', label: 'Sign Out', icon: 'LogOut' } // No href for actions
-  ];
+#### Parameters
 
-  return (
-    <NavigationMenu 
-      items={navItems}
-      mode="dropdown"
-      onNavigate={handleNavigation}
-      buttonText="Menu"
-      disabled={false}
-    />
-  );
-}
-```
+| Name | Type |
+| :------ | :------ |
+| `props` | `Omit`\<`DropdownMenuSeparatorProps` & `RefAttributes`\<`HTMLDivElement`\>, ``"ref"``\> & `RefAttributes`\<`HTMLDivElement`\> |
 
-**`Since`**
+#### Returns
 
-0.1.0
+`ReactNode`
 
 #### Defined in
 
-[packages/core/src/components/NavigationMenu/NavigationMenu.tsx:394](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/NavigationMenu/NavigationMenu.tsx#L394)
+[packages/core/src/components/DropdownMenu/DropdownMenu.tsx:308](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/DropdownMenu/DropdownMenu.tsx#L308)
 
 ___
 
-### OrganisationSelector
-
-▸ **OrganisationSelector**(`«destructured»`): ``null`` \| `Element`
-
-OrganisationSelector component for secure organisation switching
-
-This component provides secure organisation selection with:
-- User membership validation
-- Role-based access display
-- Security error handling
-- Real-time organisation switching
-- Accessible interface design
+### DropdownMenuShortcut
 
-Security: Only shows organisations the user has valid access to
+▸ **DropdownMenuShortcut**(`«destructured»`): `Element`
 
 #### Parameters
 
 | Name | Type |
 | :------ | :------ |
-| `«destructured»` | `OrganisationSelectorProps` |
+| `«destructured»` | `HTMLAttributes`\<`HTMLSpanElement`\> |
 
 #### Returns
 
-``null`` \| `Element`
+`Element`
 
 #### Defined in
 
-[packages/core/src/components/OrganisationSelector/OrganisationSelector.tsx:96](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/OrganisationSelector/OrganisationSelector.tsx#L96)
+[packages/core/src/components/DropdownMenu/DropdownMenu.tsx:320](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/DropdownMenu/DropdownMenu.tsx#L320)
 
 ___
 
-### PaceAppLayout
-
-▸ **PaceAppLayout**(`props`): `Element`
-
-A consistent layout component for all PACE suite applications that provides a standard
-structure with header, main content area, and footer.
+### EventSelector
 
-NEW: This component now includes layout-level permission enforcement to ensure
-consuming apps can't forget to implement permission checks on individual pages.
+▸ **EventSelector**(`«destructured»`): ``null`` \| `Element`
 
-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.
+EventSelector component for selecting events with built-in access control
 
-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
+This component provides secure event selection with:
+- Database integration via rbac_event_app_roles table
+- Auto-selection of next upcoming event by date
+- Cross-device sync via Supabase user session metadata
+- localStorage fallback for offline scenarios
+- Comprehensive error handling and user feedback
 
 #### Parameters
 
-| Name | Type | Description |
-| :------ | :------ | :------ |
-| `props` | [`PaceAppLayoutProps`](interfaces/PaceAppLayoutProps.md) | Layout configuration including app name for branding and permission settings |
+| Name | Type |
+| :------ | :------ |
+| `«destructured»` | `EventSelectorProps` |
 
 #### Returns
 
-`Element`
+``null`` \| `Element`
 
-React element with complete application layout structure and permission enforcement
+**`Component`**
 
 **`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 } from '@jmruthers/pace-core';
-
-function App() {
-  return (
-    <UnifiedAuthProvider supabaseClient={supabase} appName="My App">
-      <Router>
-        <Routes>
-          <Route path="/login" element={<PaceLoginPage appName="My App" />} />
-          <Route path="/" element={
-            <PaceAppLayout 
-              appName="My Application"
-              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:
-```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}
-            enforcePermissions={true}
-            filterNavigationByPermissions={true}
-            routePermissions={{
-              '/components': 'read',
-              '/styles': 'read',
-              '/meals': 'read'
-            }}
-          />
-        }>
-          <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>
-  );
-}
-```
-
-**`Since`**
-
-0.1.0
-
-#### Defined in
-
-[packages/core/src/components/PaceAppLayout/PaceAppLayout.tsx:320](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/PaceAppLayout/PaceAppLayout.tsx#L320)
-
-___
-
-### PaceLoginPage
-
-▸ **PaceLoginPage**(`props`, `deprecatedLegacyContext?`): `ReactNode`
-
-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
-- 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
-
-#### Parameters
-
-| Name | Type | Description |
-| :------ | :------ | :------ |
-| `props` | [`PaceLoginPageProps`](interfaces/PaceLoginPageProps.md) | Login page configuration including app name and redirect path |
-| `deprecatedLegacyContext?` | `any` | **`See`** [React Docs](https://legacy.reactjs.org/docs/legacy-context.html#referencing-context-in-lifecycle-methods) |
-
-#### Returns
-
-`ReactNode`
-
-JSX.Element - The rendered login page with enhanced functionality
-
-**`Example`**
-
-```tsx
-<PaceLoginPage 
-  appName="My Application" 
-  onSuccessRedirectPath="/dashboard" 
-/>
+```ts
+<UnifiedAuthProvider supabaseClient={supabase} appName="PACE">
+  <EventSelector onEventChange={(event) => console.log(event)} />
+</UnifiedAuthProvider>
 ```
 
 #### Defined in
 
-[packages/core/src/components/PaceLoginPage/PaceLoginPage.tsx:160](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/PaceLoginPage/PaceLoginPage.tsx#L160)
+[packages/core/src/components/EventSelector/EventSelector.tsx:129](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/EventSelector/EventSelector.tsx#L129)
 
 ___
 
-### PasswordChangeForm
+### Footer
 
-▸ **PasswordChangeForm**(`«destructured»`): `Element`
+▸ **Footer**(`props`): `ReactNode`
 
 #### Parameters
 
 | Name | Type |
 | :------ | :------ |
-| `«destructured»` | `PasswordChangeFormProps` |
+| `props` | [`FooterProps`](interfaces/FooterProps.md) |
 
 #### Returns
 
-`Element`
+`ReactNode`
 
 #### Defined in
 
-[packages/core/src/components/PasswordReset/PasswordChangeForm.tsx:116](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/PasswordReset/PasswordChangeForm.tsx#L116)
+[packages/core/src/components/Footer/Footer.tsx:196](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Footer/Footer.tsx#L196)
 
 ___
 
-### PasswordResetForm
-
-▸ **PasswordResetForm**(`«destructured»`): `Element`
-
-#### Parameters
-
-| Name | Type |
-| :------ | :------ |
-| `«destructured»` | `PasswordResetFormProps` |
-
-#### Returns
-
-`Element`
-
-#### Defined in
-
-[packages/core/src/components/PasswordReset/PasswordResetForm.tsx:94](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/PasswordReset/PasswordResetForm.tsx#L94)
+### Form
 
-___
+▸ **Form**\<`TFieldValues`\>(`props`): `Element`
 
-### Progress
+Form component with validation and React Hook Form integration
 
-▸ **Progress**(`props`): `ReactNode`
+#### Type parameters
 
-Progress component
-An accessible progress bar with smooth animations
+| Name | Type | Description |
+| :------ | :------ | :------ |
+| `TFieldValues` | extends `FieldValues` = `FieldValues` | The type of form field values |
 
 #### Parameters
 
 | Name | Type | Description |
 | :------ | :------ | :------ |
-| `props` | `ProgressProps` & `RefAttributes`\<`HTMLDivElement`\> | Progress configuration and styling |
+| `props` | `FormProps`\<`TFieldValues`\> | Form configuration and handlers |
 
 #### Returns
 
-`ReactNode`
+`Element`
 
-JSX.Element - The rendered progress bar
+JSX.Element - The rendered form with FormProvider context
 
 **`Example`**
 
 ```tsx
-<Progress value={75} max={100} />
+<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>
 ```
 
 #### Defined in
 
-[packages/core/src/components/Progress/Progress.tsx:90](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Progress/Progress.tsx#L90)
+[packages/core/src/components/Form/Form.tsx:142](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Form/Form.tsx#L142)
 
 ___
 
-### EventLogo
+### Header
+
+▸ **Header**(`props`): `Element`
 
-▸ **EventLogo**(`props`): ``null`` \| `Element`
+Header component for application layouts with comprehensive navigation, user management, 
+and customizable branding support.
 
-Component for displaying event logos with fallback to initials
+A flexible header component that supports various configurations including custom logos,
+navigation menus, user authentication, event selection, and custom actions.
 
-This component is context-aware and automatically detects whether it's being used
-in a public or authenticated context. It fetches and displays event logos from storage,
-with automatic fallback to event initials if no logo is available.
+Features:
+- Customizable logo (URL or custom component)
+- Navigation menu integration with highlighting
+- User menu with authentication and password management
+- Event selector for multi-tenant applications
+- Custom actions support
+- Responsive design with mobile considerations
+- Accessibility compliant with proper ARIA attributes
+- Backdrop blur effects for modern UI
+- Flexible layout with configurable sections
 
 #### Parameters
 
 | Name | Type | Description |
 | :------ | :------ | :------ |
-| `props` | [`EventLogoProps`](interfaces/EventLogoProps.md) | Logo configuration and styling |
+| `props` | `HeaderProps` | Header configuration including logo, navigation, user settings, and custom content |
 
 #### Returns
 
-``null`` \| `Element`
+`Element`
 
-React element with event logo or fallback
+React element with complete header functionality
 
-#### Defined in
+**`Example`**
 
-[packages/core/src/components/PublicLayout/EventLogo.tsx:111](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/PublicLayout/EventLogo.tsx#L111)
+Basic header with logo and navigation:
+```tsx
+import { Header } from '@jmruthers/pace-core';
+import { useNavigate, useLocation } from 'react-router-dom';
 
-___
+function AppHeader() {
+  const navigate = useNavigate();
+  const location = useLocation();
 
-### EventLogoCompact
+  const navItems = [
+    { id: 'dashboard', label: 'Dashboard', href: '/dashboard' },
+    { id: 'meals', label: 'Meals', href: '/meals' },
+    { id: 'settings', label: 'Settings', href: '/settings' }
+  ];
 
-▸ **EventLogoCompact**(`props`): `Element`
+  return (
+    <Header
+      logoUrl="/company-logo.svg"
+      logoAlt="My Company"
+      navItems={navItems}
+      currentPath={location.pathname}
+      onNavigate={(item) => navigate(item.href)}
+      user={currentUser}
+      onSignOut={handleSignOut}
+    />
+  );
+}
+```
 
-Compact event logo for small spaces
+**`Example`**
 
-#### Parameters
+Header with custom actions:
+```tsx
+import { Header, Button } from '@jmruthers/pace-core';
 
-| Name | Type |
-| :------ | :------ |
-| `props` | [`EventLogoProps`](interfaces/EventLogoProps.md) |
+function HeaderWithActions() {
+  const customActions = (
+    <div className="flex items-center gap-2">
+      <Button variant="outline" size="sm">Export</Button>
+      <Button size="sm">New Item</Button>
+    </div>
+  );
 
-#### Returns
+  return (
+    <Header
+      logoUrl="/logo.svg"
+      navItems={navigationItems}
+      actions={customActions}
+      user={currentUser}
+      onSignOut={handleSignOut}
+    />
+  );
+}
+```
 
-`Element`
+**`Example`**
+
+Minimal header configuration:
+```tsx
+function MinimalHeader() {
+  return (
+    <Header
+      logoUrl="/simple-logo.svg"
+      logoAlt="Simple App"
+      showEventSelector={false}
+      user={currentUser}
+      onSignOut={handleSignOut}
+    />
+  );
+}
+```
+
+**`Since`**
+
+0.1.0
 
 #### Defined in
 
-[packages/core/src/components/PublicLayout/EventLogo.tsx:266](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/PublicLayout/EventLogo.tsx#L266)
+[packages/core/src/components/Header/Header.tsx:219](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Header/Header.tsx#L219)
 
 ___
 
-### EventLogoLarge
+### Input
 
-▸ **EventLogoLarge**(`props`): `Element`
+▸ **Input**(`props`): `ReactNode`
 
-Large event logo for prominent display
+Input component
+A flexible, accessible input component with multiple variants and sizes
 
 #### Parameters
 
-| Name | Type |
-| :------ | :------ |
-| `props` | [`EventLogoProps`](interfaces/EventLogoProps.md) |
+| Name | Type | Description |
+| :------ | :------ | :------ |
+| `props` | [`InputProps`](interfaces/InputProps.md) & `RefAttributes`\<`HTMLInputElement`\> | Input configuration and styling |
 
 #### Returns
 
-`Element`
-
-#### Defined in
-
-[packages/core/src/components/PublicLayout/EventLogo.tsx:279](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/PublicLayout/EventLogo.tsx#L279)
-
-___
-
-### useErrorBoundary
+`ReactNode`
 
-▸ **useErrorBoundary**(): `Object`
+JSX.Element - The rendered input element
 
-Hook for accessing error boundary state
-Useful for components that need to know if they're inside an error boundary
+**`Example`**
 
-#### Returns
+```tsx
+// Basic input
+<Input placeholder="Enter your name" />
 
-`Object`
+// Input with error state
+<Input 
+  placeholder="Email" 
+  type="email" 
+  error={true}
+/>
 
-| Name | Type |
-| :------ | :------ |
-| `captureError` | (`error`: `Error`) => `void` |
-| `resetError` | () => `void` |
+// Large input with destructive variant
+<Input 
+  variant="destructive" 
+  size="lg" 
+  placeholder="Error input" 
+/>
+```
 
 #### Defined in
 
-[packages/core/src/components/PublicLayout/PublicErrorBoundary.tsx:216](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/PublicLayout/PublicErrorBoundary.tsx#L216)
+[packages/core/src/components/Input/Input.tsx:104](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Input/Input.tsx#L104)
 
 ___
 
-### DefaultPublicErrorFallback
+### Label
 
-▸ **DefaultPublicErrorFallback**(`«destructured»`): `Element`
+▸ **Label**(`props`): `ReactNode`
 
-Default error fallback component
+Label component
+An accessible label with helper text and error state support
 
 #### Parameters
 
-| Name | Type |
-| :------ | :------ |
-| `«destructured»` | [`PublicErrorBoundaryState`](interfaces/PublicErrorBoundaryState.md) |
+| Name | Type | Description |
+| :------ | :------ | :------ |
+| `props` | [`LabelProps`](interfaces/LabelProps.md) & `RefAttributes`\<`HTMLLabelElement`\> | Label configuration and styling |
 
 #### Returns
 
-`Element`
+`ReactNode`
+
+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>
+```
 
 #### Defined in
 
-[packages/core/src/components/PublicLayout/PublicErrorBoundary.tsx:239](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/PublicLayout/PublicErrorBoundary.tsx#L239)
+[packages/core/src/components/Label/Label.tsx:120](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Label/Label.tsx#L120)
 
 ___
 
-### PublicLoadingSpinner
-
-▸ **PublicLoadingSpinner**(`props`): `Element`
+### LoadingSpinner
 
-Loading spinner component for public pages
+▸ **LoadingSpinner**(`props`, `deprecatedLegacyContext?`): `ReactNode`
 
-This component displays a consistent loading state with optional
-branding and messaging for public pages.
+LoadingSpinner component
+A simple, accessible loading spinner for indicating loading states
 
 #### Parameters
 
 | Name | Type | Description |
 | :------ | :------ | :------ |
-| `props` | [`PublicLoadingSpinnerProps`](interfaces/PublicLoadingSpinnerProps.md) | Spinner configuration and styling |
+| `props` | `LoadingSpinnerProps` | Spinner configuration and styling |
+| `deprecatedLegacyContext?` | `any` | **`See`** [React Docs](https://legacy.reactjs.org/docs/legacy-context.html#referencing-context-in-lifecycle-methods) |
 
 #### Returns
 
-`Element`
+`ReactNode`
 
-React element with loading spinner
+JSX.Element - The rendered loading spinner
+
+**`Example`**
+
+```tsx
+<LoadingSpinner size="lg" className="text-app-main-500" />
+```
 
 #### Defined in
 
-[packages/core/src/components/PublicLayout/PublicLoadingSpinner.tsx:75](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/PublicLayout/PublicLoadingSpinner.tsx#L75)
+[packages/core/src/components/LoadingSpinner/LoadingSpinner.tsx:83](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/LoadingSpinner/LoadingSpinner.tsx#L83)
 
 ___
 
-### PublicLoadingSpinnerFullPage
+### LoginForm
 
-▸ **PublicLoadingSpinnerFullPage**(`«destructured»`): `Element`
+▸ **LoginForm**(`props`): `ReactNode`
 
-Full page loading spinner with event branding
+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.
 
 #### Parameters
 
-| Name | Type |
-| :------ | :------ |
-| `«destructured»` | `Pick`\<[`PublicLoadingSpinnerProps`](interfaces/PublicLoadingSpinnerProps.md), ``"message"`` \| ``"className"``\> & \{ `eventName?`: `string`  } |
+| Name | Type | Description |
+| :------ | :------ | :------ |
+| `props` | [`LoginFormProps`](interfaces/LoginFormProps.md) | Login form configuration and handlers |
 
 #### Returns
 
-`Element`
+`ReactNode`
+
+JSX.Element - The rendered login form
+
+**`Example`**
+
+```tsx
+<LoginForm
+  onSignIn={handleSignIn}
+  onSuccess={() => navigate('/dashboard')}
+  onError={(error) => toast.error(error.message)}
+  isLoading={isAuthenticating}
+/>
+```
 
 #### Defined in
 
-[packages/core/src/components/PublicLayout/PublicLoadingSpinner.tsx:135](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/PublicLayout/PublicLoadingSpinner.tsx#L135)
+[packages/core/src/components/LoginForm/LoginForm.tsx:150](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/LoginForm/LoginForm.tsx#L150)
 
 ___
 
-### PublicLoadingSkeleton
+### NavigationMenu
+
+▸ **NavigationMenu**(`props`): `ReactNode`
 
-▸ **PublicLoadingSkeleton**(`«destructured»`): `Element`
+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.
 
-Skeleton loading component for content placeholders
+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)
 
 #### Parameters
 
-| Name | Type | Default value |
+| Name | Type | Description |
 | :------ | :------ | :------ |
-| `«destructured»` | `Object` | `undefined` |
-| › `lines?` | `number` | `3` |
-| › `className?` | `string` | `''` |
+| `props` | [`NavigationMenuProps`](interfaces/NavigationMenuProps.md) & `RefAttributes`\<`HTMLDivElement`\> | NavigationMenu component props including items, mode, navigation handlers, and styling options |
 
 #### Returns
 
-`Element`
+`ReactNode`
 
-#### Defined in
+React element with navigation menu functionality
 
-[packages/core/src/components/PublicLayout/PublicLoadingSpinner.tsx:189](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/PublicLayout/PublicLoadingSpinner.tsx#L189)
+**`Example`**
 
-___
+Basic dropdown navigation (most common use case):
+```tsx
+import { NavigationMenu } from '@jmruthers/pace-core';
+import { useNavigate, useLocation } from 'react-router-dom';
 
-### PublicPageContextChecker
+function AppNavigation() {
+  const navigate = useNavigate();
+  const location = useLocation();
 
-▸ **PublicPageContextChecker**(`«destructured»`): ``null`` \| `Element`
+  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' }
+  ];
 
-Context checker component that immediately identifies authentication context issues
+  return (
+    <NavigationMenu 
+      items={navItems}
+      mode="dropdown"
+      currentPath={location.pathname}
+      onNavigate={(item) => navigate(item.href)}
+      buttonText="Main Menu"
+      showIcons={true}
+    />
+  );
+}
+```
 
-This component will immediately log to console if authentication context
-is being triggered in a public page.
+**`Example`**
 
-#### Parameters
+Hierarchical navigation with nested items:
+```tsx
+import { NavigationMenu } from '@jmruthers/pace-core';
 
-| Name | Type |
-| :------ | :------ |
-| `«destructured»` | `PublicPageContextCheckerProps` |
+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' }
+  ];
 
-#### Returns
+  return (
+    <NavigationMenu 
+      items={hierarchicalItems}
+      mode="hierarchical"
+      currentPath={window.location.pathname}
+      onNavigate={(item) => {
+        if (item.href) {
+          window.location.href = item.href;
+        }
+      }}
+      className="w-64 bg-gray-50 p-4"
+    />
+  );
+}
+```
 
-``null`` \| `Element`
+**`Example`**
 
-#### Defined in
+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';
 
-[packages/core/src/components/PublicLayout/PublicPageContextChecker.tsx:27](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/PublicLayout/PublicPageContextChecker.tsx#L27)
+function AuthenticatedNavigation() {
+  const navigate = useNavigate();
+  const location = useLocation();
+  const { hasRole, hasPermission } = useUnifiedAuth();
 
-___
+  // Build navigation items based on user permissions
+  const navItems = [
+    { id: 'dashboard', label: 'Dashboard', href: '/dashboard', icon: 'LayoutDashboard' },
+    ...(hasPermission('meals:read') ? [
+      { id: 'meals', label: 'Meals', href: '/meals', icon: 'UtensilsCrossed' }
+    ] : []),
+    ...(hasRole('admin') ? [
+      { id: 'admin', label: 'Admin Panel', href: '/admin', icon: 'Shield' }
+    ] : []),
+    { id: 'profile', label: 'Profile', href: '/profile', icon: 'User' }
+  ];
 
-### PublicPageDebugger
+  return (
+    <NavigationMenu 
+      items={navItems}
+      mode="dropdown"
+      currentPath={location.pathname}
+      onNavigate={(item) => navigate(item.href)}
+      buttonText="Navigation"
+      navigationLabel="Main application navigation"
+    />
+  );
+}
+```
 
-▸ **PublicPageDebugger**(`«destructured»`): ``null`` \| `Element`
+**`Example`**
 
-Debugger component that logs context information
+Custom navigation with external links and actions:
+```tsx
+import { NavigationMenu } from '@jmruthers/pace-core';
 
-This component helps identify why authentication context
-is being triggered in public pages.
+function CustomNavigation() {
+  const handleNavigation = (item) => {
+    if (item.id === 'logout') {
+      // Handle logout action
+      handleLogout();
+    } else if (item.href?.startsWith('http')) {
+      // Handle external links
+      window.open(item.href, '_blank');
+    } else if (item.href) {
+      // Handle internal navigation
+      navigate(item.href);
+    }
+  };
 
-#### Parameters
+  const navItems = [
+    { id: 'home', label: 'Home', href: '/', icon: 'Home' },
+    { id: 'help', label: 'Help Center', href: 'https://help.example.com', icon: 'HelpCircle' },
+    { id: 'logout', label: 'Sign Out', icon: 'LogOut' } // No href for actions
+  ];
 
-| Name | Type |
-| :------ | :------ |
-| `«destructured»` | `PublicPageDebuggerProps` |
+  return (
+    <NavigationMenu 
+      items={navItems}
+      mode="dropdown"
+      onNavigate={handleNavigation}
+      buttonText="Menu"
+      disabled={false}
+    />
+  );
+}
+```
 
-#### Returns
+**`Since`**
 
-``null`` \| `Element`
+0.1.0
 
 #### Defined in
 
-[packages/core/src/components/PublicLayout/PublicPageDebugger.tsx:27](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/PublicLayout/PublicPageDebugger.tsx#L27)
+[packages/core/src/components/NavigationMenu/NavigationMenu.tsx:377](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/NavigationMenu/NavigationMenu.tsx#L377)
 
 ___
 
-### PublicPageDiagnostic
+### OrganisationSelector
 
-▸ **PublicPageDiagnostic**(`«destructured»`): ``null`` \| `Element`
+▸ **OrganisationSelector**(`«destructured»`): ``null`` \| `Element`
 
-Diagnostic component that identifies authentication context issues
+OrganisationSelector component for secure organisation switching
+
+This component provides secure organisation selection with:
+- User membership validation
+- Role-based access display
+- Security error handling
+- Real-time organisation switching
+- Accessible interface design
 
-This component will help you identify exactly where the problem is
-in your public page implementation.
+Security: Only shows organisations the user has valid access to
 
 #### Parameters
 
 | Name | Type |
 | :------ | :------ |
-| `«destructured»` | `PublicPageDiagnosticProps` |
+| `«destructured»` | `OrganisationSelectorProps` |
 
 #### Returns
 
@@ -2202,139 +1842,236 @@ in your public page implementation.
 
 #### Defined in
 
-[packages/core/src/components/PublicLayout/PublicPageDiagnostic.tsx:27](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/PublicLayout/PublicPageDiagnostic.tsx#L27)
+[packages/core/src/components/OrganisationSelector/OrganisationSelector.tsx:96](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/OrganisationSelector/OrganisationSelector.tsx#L96)
 
 ___
 
-### PublicPageFooter
+### PaceAppLayout
+
+▸ **PaceAppLayout**(`props`): `Element`
 
-▸ **PublicPageFooter**(`props`): `Element`
+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.
 
-Footer component for public pages that matches the normal Footer exactly
+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.
 
-This component uses the same styling and structure as the main Footer component
-to ensure consistency across the application.
+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
 
 #### Parameters
 
 | Name | Type | Description |
 | :------ | :------ | :------ |
-| `props` | [`PublicPageFooterProps`](interfaces/PublicPageFooterProps.md) | Footer configuration and content |
+| `props` | [`PaceAppLayoutProps`](interfaces/PaceAppLayoutProps.md) | Layout configuration including app name for branding and permission settings |
 
 #### Returns
 
-`Element`
+`Element`
+
+React element with complete application layout structure and permission enforcement
+
+**`Example`**
+
+Basic React Router setup with permission enforcement:
+```tsx
+import { BrowserRouter as Router, Routes, Route } from 'react-router-dom';
+import { UnifiedAuthProvider } from '@jmruthers/pace-core/providers';
+import { PaceAppLayout, PaceLoginPage } from '@jmruthers/pace-core';
+
+function App() {
+  return (
+    <UnifiedAuthProvider supabaseClient={supabase} appName="My App">
+      <Router>
+        <Routes>
+          <Route path="/login" element={<PaceLoginPage appName="My App" />} />
+          <Route path="/" element={
+            <PaceAppLayout 
+              appName="My Application"
+              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:
+```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}
+            enforcePermissions={true}
+            filterNavigationByPermissions={true}
+            routePermissions={{
+              '/components': 'read',
+              '/styles': 'read',
+              '/meals': 'read'
+            }}
+          />
+        }>
+          <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>
+  );
+}
+```
+
+**`Since`**
 
-React element with public page footer
+0.1.0
 
 #### Defined in
 
-[packages/core/src/components/PublicLayout/PublicPageFooter.tsx:79](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/PublicLayout/PublicPageFooter.tsx#L79)
+[packages/core/src/components/PaceAppLayout/PaceAppLayout.tsx:331](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/PaceAppLayout/PaceAppLayout.tsx#L331)
 
 ___
 
-### PublicPageHeader
+### PaceLoginPage
 
-▸ **PublicPageHeader**(`props`): `Element`
+▸ **PaceLoginPage**(`props`, `deprecatedLegacyContext?`): `ReactNode`
 
-Header component for public pages with event-specific branding
+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.
 
-This component displays the app logo, event logo, and event information
-in a clean, accessible layout suitable for public pages.
+Recent enhancements:
+- Role-based redirection: Admin users are automatically redirected
+- 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
 
 #### Parameters
 
 | Name | Type | Description |
 | :------ | :------ | :------ |
-| `props` | [`PublicPageHeaderProps`](interfaces/PublicPageHeaderProps.md) | Header configuration and content |
+| `props` | [`PaceLoginPageProps`](interfaces/PaceLoginPageProps.md) | Login page configuration including app name and redirect path |
+| `deprecatedLegacyContext?` | `any` | **`See`** [React Docs](https://legacy.reactjs.org/docs/legacy-context.html#referencing-context-in-lifecycle-methods) |
 
 #### Returns
 
-`Element`
-
-React element with public page header
-
-#### Defined in
-
-[packages/core/src/components/PublicLayout/PublicPageHeader.tsx:85](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/PublicLayout/PublicPageHeader.tsx#L85)
-
-___
-
-### PublicPageLayout
-
-▸ **PublicPageLayout**(`props`): `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.
-
-#### Parameters
-
-| Name | Type | Description |
-| :------ | :------ | :------ |
-| `props` | [`PublicPageLayoutProps`](interfaces/PublicPageLayoutProps.md) | Layout configuration and content |
+`ReactNode`
 
-#### Returns
+JSX.Element - The rendered login page with enhanced functionality
 
-`Element`
+**`Example`**
 
-React element with complete public page layout
+```tsx
+<PaceLoginPage 
+  appName="My Application" 
+  onSuccessRedirectPath="/dashboard" 
+/>
+```
 
 #### Defined in
 
-[packages/core/src/components/PublicLayout/PublicPageLayout.tsx:101](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/PublicLayout/PublicPageLayout.tsx#L101)
+[packages/core/src/components/PaceLoginPage/PaceLoginPage.tsx:160](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/PaceLoginPage/PaceLoginPage.tsx#L160)
 
 ___
 
-### usePublicPageContext
+### PasswordChangeForm
 
-▸ **usePublicPageContext**(): `Object`
+▸ **PasswordChangeForm**(`«destructured»`): `Element`
 
-Hook for accessing public page context
-Provides access to event data and layout state within public pages
+#### Parameters
 
- This hook is no longer needed as PublicPageLayout no longer
-automatically fetches event data. Use usePublicRouteParams and usePublicEvent
-directly in your components instead.
+| Name | Type |
+| :------ | :------ |
+| `«destructured»` | `PasswordChangeFormProps` |
 
 #### Returns
 
-`Object`
-
-| Name | Type |
-| :------ | :------ |
-| `eventCode` | ``null`` |
-| `eventId` | ``null`` |
-| `event` | ``null`` |
-| `isLoading` | `boolean` |
-| `error` | ``null`` |
-| `refetch` | () => `Promise`\<`void`\> |
-| `isPublicPage` | `boolean` |
+`Element`
 
 #### Defined in
 
-[packages/core/src/components/PublicLayout/PublicPageLayout.tsx:221](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/PublicLayout/PublicPageLayout.tsx#L221)
+[packages/core/src/components/PasswordReset/PasswordChangeForm.tsx:116](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/PasswordReset/PasswordChangeForm.tsx#L116)
 
 ___
 
-### PublicPageProvider
-
-▸ **PublicPageProvider**(`«destructured»`): `Element`
-
-Provider for public pages that completely isolates them from authentication context
+### PasswordResetForm
 
-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
+▸ **PasswordResetForm**(`«destructured»`): `Element`
 
 #### Parameters
 
 | Name | Type |
 | :------ | :------ |
-| `«destructured»` | `PublicPageProviderProps` |
+| `«destructured»` | `PasswordResetFormProps` |
 
 #### Returns
 
@@ -2342,43 +2079,38 @@ This provider:
 
 #### Defined in
 
-[packages/core/src/components/PublicLayout/PublicPageProvider.tsx:64](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/PublicLayout/PublicPageProvider.tsx#L64)
+[packages/core/src/components/PasswordReset/PasswordResetForm.tsx:94](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/PasswordReset/PasswordResetForm.tsx#L94)
 
 ___
 
-### usePublicPageProviderContext
-
-▸ **usePublicPageProviderContext**(): `PublicPageContextType`
-
-Hook to access public page context
-
-#### Returns
-
-`PublicPageContextType`
-
-Public page context with environment variables
+### Progress
 
-#### Defined in
+▸ **Progress**(`props`): `ReactNode`
 
-[packages/core/src/components/PublicLayout/PublicPageProvider.tsx:119](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/PublicLayout/PublicPageProvider.tsx#L119)
+Progress component
+An accessible progress bar with smooth animations
 
-___
+#### Parameters
 
-### useIsPublicPage
+| Name | Type | Description |
+| :------ | :------ | :------ |
+| `props` | `ProgressProps` & `RefAttributes`\<`HTMLDivElement`\> | Progress configuration and styling |
 
-▸ **useIsPublicPage**(): `boolean`
+#### Returns
 
-Hook to check if we're in a public page context
+`ReactNode`
 
-#### Returns
+JSX.Element - The rendered progress bar
 
-`boolean`
+**`Example`**
 
-True if we're in a public page context
+```tsx
+<Progress value={75} max={100} />
+```
 
 #### Defined in
 
-[packages/core/src/components/PublicLayout/PublicPageProvider.tsx:134](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/PublicLayout/PublicPageProvider.tsx#L134)
+[packages/core/src/components/Progress/Progress.tsx:90](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Progress/Progress.tsx#L90)
 
 ___
 
@@ -2390,7 +2122,7 @@ ___
 
 | Name | Type |
 | :------ | :------ |
-| `props` | `SelectProps` & `RefAttributes`\<`HTMLFormElement`\> |
+| `props` | `SelectProps` & `RefAttributes`\<`HTMLDivElement`\> |
 
 #### Returns
 
@@ -2398,7 +2130,7 @@ ___
 
 #### Defined in
 
-[packages/core/src/components/Select/Select.tsx:96](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Select/Select.tsx#L96)
+[packages/core/src/components/Select/Select.tsx:94](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Select/Select.tsx#L94)
 
 ___
 
@@ -2418,7 +2150,7 @@ ___
 
 #### Defined in
 
-[packages/core/src/components/Select/Select.tsx:275](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Select/Select.tsx#L275)
+[packages/core/src/components/Select/Select.tsx:160](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Select/Select.tsx#L160)
 
 ___
 
@@ -2430,7 +2162,7 @@ ___
 
 | Name | Type |
 | :------ | :------ |
-| `props` | `SelectValueProps` & `RefAttributes`\<`HTMLSpanElement`\> |
+| `props` | `SelectValueProps` & `RefAttributes`\<`HTMLDivElement`\> |
 
 #### Returns
 
@@ -2438,7 +2170,7 @@ ___
 
 #### Defined in
 
-[packages/core/src/components/Select/Select.tsx:398](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Select/Select.tsx#L398)
+[packages/core/src/components/Select/Select.tsx:234](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Select/Select.tsx#L234)
 
 ___
 
@@ -2450,7 +2182,7 @@ ___
 
 | Name | Type |
 | :------ | :------ |
-| `props` | `SelectContentProps` & `RefAttributes`\<`HTMLUListElement`\> |
+| `props` | `SelectContentProps` & `RefAttributes`\<`HTMLDivElement`\> |
 
 #### Returns
 
@@ -2458,7 +2190,7 @@ ___
 
 #### Defined in
 
-[packages/core/src/components/Select/Select.tsx:415](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Select/Select.tsx#L415)
+[packages/core/src/components/Select/Select.tsx:270](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Select/Select.tsx#L270)
 
 ___
 
@@ -2470,7 +2202,7 @@ ___
 
 | Name | Type |
 | :------ | :------ |
-| `props` | `SelectItemProps` & `RefAttributes`\<`HTMLLIElement`\> |
+| `props` | `SelectItemProps` & `RefAttributes`\<`HTMLDivElement`\> |
 
 #### Returns
 
@@ -2478,7 +2210,7 @@ ___
 
 #### Defined in
 
-[packages/core/src/components/Select/Select.tsx:542](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Select/Select.tsx#L542)
+[packages/core/src/components/Select/Select.tsx:470](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Select/Select.tsx#L470)
 
 ___
 
@@ -2498,7 +2230,7 @@ ___
 
 #### Defined in
 
-[packages/core/src/components/Select/Select.tsx:627](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Select/Select.tsx#L627)
+[packages/core/src/components/Select/Select.tsx:538](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Select/Select.tsx#L538)
 
 ___
 
@@ -2518,7 +2250,7 @@ ___
 
 #### Defined in
 
-[packages/core/src/components/Select/Select.tsx:638](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Select/Select.tsx#L638)
+[packages/core/src/components/Select/Select.tsx:547](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Select/Select.tsx#L547)
 
 ___
 
@@ -2538,7 +2270,7 @@ ___
 
 #### Defined in
 
-[packages/core/src/components/Select/Select.tsx:649](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Select/Select.tsx#L649)
+[packages/core/src/components/Select/Select.tsx:560](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Select/Select.tsx#L560)
 
 ___
 
@@ -3077,7 +2809,7 @@ JSX.Element - The tooltip content container
 **`Example`**
 
 ```tsx
-<TooltipContent side="top" className="bg-main-500">
+<TooltipContent side="top" className="bg-app-main-500">
   Custom tooltip content
 </TooltipContent>
 ```
@@ -3121,258 +2853,23 @@ JSX.Element - The tooltip with trigger and content
 
 ___
 
-### UserMenu
-
-▸ **UserMenu**(`props`): `ReactNode`
-
-#### Parameters
-
-| Name | Type |
-| :------ | :------ |
-| `props` | [`UserMenuProps`](interfaces/UserMenuProps.md) |
-
-#### Returns
-
-`ReactNode`
-
-#### Defined in
-
-[packages/core/src/components/UserMenu/UserMenu.tsx:136](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/UserMenu/UserMenu.tsx#L136)
-
-___
-
-### usePublicEvent
-
-▸ **usePublicEvent**(`eventCode`, `options?`): [`UsePublicEventReturn`](interfaces/UsePublicEventReturn.md)
-
-Hook for accessing public event data by event_code
-
-This hook provides access to public event information without requiring
-authentication. It includes caching, error handling, and loading states.
-
-#### Parameters
-
-| Name | Type | Description |
-| :------ | :------ | :------ |
-| `eventCode` | `string` | The event code to look up |
-| `options` | [`UsePublicEventOptions`](interfaces/UsePublicEventOptions.md) | Configuration options for caching and behavior |
-
-#### Returns
-
-[`UsePublicEventReturn`](interfaces/UsePublicEventReturn.md)
-
-Object containing event data, loading state, error, and refetch function
-
-#### Defined in
-
-[packages/core/src/hooks/public/usePublicEvent.ts:99](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/hooks/public/usePublicEvent.ts#L99)
-
-___
-
-### clearPublicEventCache
-
-▸ **clearPublicEventCache**(): `void`
-
-Clear all cached public event data
-Useful for testing or when you need to force refresh all data
-
-#### Returns
-
-`void`
-
-#### Defined in
-
-[packages/core/src/hooks/public/usePublicEvent.ts:244](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/hooks/public/usePublicEvent.ts#L244)
-
-___
-
-### getPublicEventCacheStats
-
-▸ **getPublicEventCacheStats**(): `Object`
-
-Get cache statistics for debugging
-
-#### Returns
-
-`Object`
-
-| Name | Type |
-| :------ | :------ |
-| `size` | `number` |
-| `keys` | `string`[] |
-
-#### Defined in
-
-[packages/core/src/hooks/public/usePublicEvent.ts:255](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/hooks/public/usePublicEvent.ts#L255)
-
-___
-
-### usePublicEventLogo
-
-▸ **usePublicEventLogo**(`eventId`, `eventName`, `organisationId`, `options`): [`UsePublicEventLogoReturn`](interfaces/UsePublicEventLogoReturn.md)
-
-Hook for accessing public event logo URLs
-
-This hook provides access to event logo URLs without requiring
-authentication. It includes fallback handling and image validation.
-
-#### Parameters
-
-| Name | Type | Description |
-| :------ | :------ | :------ |
-| `eventId` | `undefined` \| `string` | The event ID to fetch logo for |
-| `eventName` | `undefined` \| `string` | The event name for fallback text generation |
-| `organisationId` | `undefined` \| `string` | The organisation ID for storage path |
-| `options` | [`UsePublicEventLogoOptions`](interfaces/UsePublicEventLogoOptions.md) | Configuration options for caching and behavior |
-
-#### Returns
-
-[`UsePublicEventLogoReturn`](interfaces/UsePublicEventLogoReturn.md)
-
-Object containing logo URL, fallback text, loading state, error, and refetch function
-
-#### Defined in
-
-[packages/core/src/hooks/public/usePublicEventLogo.ts:125](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/hooks/public/usePublicEventLogo.ts#L125)
-
-___
-
-### clearPublicLogoCache
-
-▸ **clearPublicLogoCache**(): `void`
-
-Clear all cached public logo data
-Useful for testing or when you need to force refresh all data
-
-#### Returns
-
-`void`
-
-#### Defined in
-
-[packages/core/src/hooks/public/usePublicEventLogo.ts:268](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/hooks/public/usePublicEventLogo.ts#L268)
-
-___
-
-### getPublicLogoCacheStats
-
-▸ **getPublicLogoCacheStats**(): `Object`
-
-Get cache statistics for debugging
-
-#### Returns
-
-`Object`
-
-| Name | Type |
-| :------ | :------ |
-| `size` | `number` |
-| `keys` | `string`[] |
-
-#### Defined in
-
-[packages/core/src/hooks/public/usePublicEventLogo.ts:279](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/hooks/public/usePublicEventLogo.ts#L279)
-
-___
-
-### usePublicRouteParams
-
-▸ **usePublicRouteParams**(`options?`): [`UsePublicRouteParamsReturn`](interfaces/UsePublicRouteParamsReturn.md)
-
-Hook for extracting and validating public route parameters
-
-This hook extracts event codes from URL parameters and optionally
-fetches the corresponding event data. It provides validation and
-error handling for public routes.
-
-#### Parameters
-
-| Name | Type | Description |
-| :------ | :------ | :------ |
-| `options` | `UsePublicRouteParamsOptions` | Configuration options for behavior |
-
-#### Returns
-
-[`UsePublicRouteParamsReturn`](interfaces/UsePublicRouteParamsReturn.md)
-
-Object containing route parameters, event data, loading state, error, and refetch function
-
-#### Defined in
-
-[packages/core/src/hooks/public/usePublicRouteParams.ts:111](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/hooks/public/usePublicRouteParams.ts#L111)
-
-___
-
-### usePublicEventCode
-
-▸ **usePublicEventCode**(`eventCodeParam?`): `Object`
-
-Hook for extracting just the event code without fetching event data
-Useful when you only need the event code and will fetch data separately
-
-#### Parameters
-
-| Name | Type | Default value |
-| :------ | :------ | :------ |
-| `eventCodeParam` | `string` | `'eventCode'` |
-
-#### Returns
-
-`Object`
-
-| Name | Type |
-| :------ | :------ |
-| `eventCode` | `string` \| ``null`` |
-| `error` | `Error` \| ``null`` |
-
-#### Defined in
-
-[packages/core/src/hooks/public/usePublicRouteParams.ts:206](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/hooks/public/usePublicRouteParams.ts#L206)
-
-___
-
-### generatePublicRoutePath
-
-▸ **generatePublicRoutePath**(`eventCode`, `pageName?`): `string`
-
-Utility function to generate public route paths
-
-#### Parameters
-
-| Name | Type | Default value |
-| :------ | :------ | :------ |
-| `eventCode` | `string` | `undefined` |
-| `pageName` | `string` | `'index'` |
-
-#### Returns
-
-`string`
-
-#### Defined in
-
-[packages/core/src/hooks/public/usePublicRouteParams.ts:242](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/hooks/public/usePublicRouteParams.ts#L242)
-
-___
-
-### extractEventCodeFromPath
-
-▸ **extractEventCodeFromPath**(`path`): `string` \| ``null``
+### UserMenu
 
-Utility function to extract event code from a public route path
+▸ **UserMenu**(`props`): `ReactNode`
 
 #### Parameters
 
 | Name | Type |
 | :------ | :------ |
-| `path` | `string` |
+| `props` | [`UserMenuProps`](interfaces/UserMenuProps.md) |
 
 #### Returns
 
-`string` \| ``null``
+`ReactNode`
 
 #### Defined in
 
-[packages/core/src/hooks/public/usePublicRouteParams.ts:256](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/hooks/public/usePublicRouteParams.ts#L256)
+[packages/core/src/components/UserMenu/UserMenu.tsx:135](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/UserMenu/UserMenu.tsx#L135)
 
 ___
 
@@ -3381,7 +2878,6 @@ ___
 ▸ **useAppConfig**(): `UseAppConfigReturn`
 
 Hook to access app configuration
-Works in both authenticated and public contexts
 
 #### Returns
 
@@ -3391,27 +2887,7 @@ App configuration and loading state
 
 #### Defined in
 
-[packages/core/src/hooks/useAppConfig.ts:46](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/hooks/useAppConfig.ts#L46)
-
-___
-
-### useInactivityTracker
-
-▸ **useInactivityTracker**(`«destructured»?`): [`UseInactivityTrackerReturn`](interfaces/UseInactivityTrackerReturn.md)
-
-#### Parameters
-
-| Name | Type |
-| :------ | :------ |
-| `«destructured»` | [`UseInactivityTrackerOptions`](interfaces/UseInactivityTrackerOptions.md) |
-
-#### Returns
-
-[`UseInactivityTrackerReturn`](interfaces/UseInactivityTrackerReturn.md)
-
-#### Defined in
-
-[packages/core/src/hooks/useInactivityTracker.ts:127](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/hooks/useInactivityTracker.ts#L127)
+[packages/core/src/hooks/useAppConfig.ts:44](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/hooks/useAppConfig.ts#L44)
 
 ___
 
@@ -3453,57 +2929,6 @@ ___
 
 ___
 
-### useStorage
-
-▸ **useStorage**(`«destructured»`): `UseStorageReturn`
-
-Hook for storage operations with app and organisation context
-
-#### Parameters
-
-| Name | Type |
-| :------ | :------ |
-| `«destructured»` | `UseStorageOptions` |
-
-#### Returns
-
-`UseStorageReturn`
-
-#### Defined in
-
-[packages/core/src/hooks/useStorage.ts:57](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/hooks/useStorage.ts#L57)
-
-___
-
-### useFileUpload
-
-▸ **useFileUpload**(`«destructured»`): `Object`
-
-Hook for file upload with progress tracking
-
-#### Parameters
-
-| Name | Type |
-| :------ | :------ |
-| `«destructured»` | `UseStorageOptions` |
-
-#### Returns
-
-`Object`
-
-| Name | Type |
-| :------ | :------ |
-| `uploadWithProgress` | (`file`: `File`, `options`: `Partial`\<[`StorageUploadOptions`](interfaces/StorageUploadOptions.md)\>) => `Promise`\<[`StorageUploadResult`](interfaces/StorageUploadResult.md)\> |
-| `uploadProgress` | `number` |
-| `isUploading` | `boolean` |
-| `uploadError` | ``null`` \| `string` |
-
-#### Defined in
-
-[packages/core/src/hooks/useStorage.ts:219](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/hooks/useStorage.ts#L219)
-
-___
-
 ### useEvents
 
 ▸ **useEvents**(): [`EventContextType`](interfaces/EventContextType.md)
@@ -3514,7 +2939,7 @@ ___
 
 #### Defined in
 
-[packages/core/src/providers/EventProvider.tsx:29](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/providers/EventProvider.tsx#L29)
+[packages/core/src/providers/EventProvider.tsx:27](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/providers/EventProvider.tsx#L27)
 
 ___
 
@@ -3534,7 +2959,7 @@ ___
 
 #### Defined in
 
-[packages/core/src/providers/EventProvider.tsx:68](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/providers/EventProvider.tsx#L68)
+[packages/core/src/providers/EventProvider.tsx:66](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/providers/EventProvider.tsx#L66)
 
 ___
 
@@ -3566,7 +2991,7 @@ SECURITY: No children are rendered without valid organisation context
 
 #### Defined in
 
-[packages/core/src/providers/OrganisationProvider.tsx:103](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/providers/OrganisationProvider.tsx#L103)
+[packages/core/src/providers/OrganisationProvider.tsx:101](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/providers/OrganisationProvider.tsx#L101)
 
 ___
 
@@ -3588,7 +3013,7 @@ If used outside OrganisationProvider
 
 #### Defined in
 
-[packages/core/src/providers/OrganisationProvider.tsx:574](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/providers/OrganisationProvider.tsx#L574)
+[packages/core/src/providers/OrganisationProvider.tsx:539](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/providers/OrganisationProvider.tsx#L539)
 
 ___
 
@@ -3602,7 +3027,7 @@ ___
 
 #### Defined in
 
-[packages/core/src/providers/UnifiedAuthProvider.tsx:177](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/providers/UnifiedAuthProvider.tsx#L177)
+[packages/core/src/providers/UnifiedAuthProvider.tsx:231](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/providers/UnifiedAuthProvider.tsx#L231)
 
 ___
 
@@ -3622,7 +3047,7 @@ ___
 
 #### Defined in
 
-[packages/core/src/providers/UnifiedAuthProvider.tsx:294](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/providers/UnifiedAuthProvider.tsx#L294)
+[packages/core/src/providers/UnifiedAuthProvider.tsx:338](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/providers/UnifiedAuthProvider.tsx#L338)
 
 ___
 
@@ -3634,7 +3059,7 @@ ___
 
 | Name | Type |
 | :------ | :------ |
-| `style` | ``"core"`` |
+| `style` | ``"base"`` \| ``"dark"`` \| ``"theme"`` |
 
 #### Returns
 
@@ -3642,7 +3067,7 @@ ___
 
 #### Defined in
 
-[packages/core/src/styles/index.ts:40](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/styles/index.ts#L40)
+[packages/core/src/styles/index.ts:50](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/styles/index.ts#L50)
 
 ___
 
@@ -3656,7 +3081,7 @@ ___
 
 #### Defined in
 
-[packages/core/src/styles/index.ts:45](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/styles/index.ts#L45)
+[packages/core/src/styles/index.ts:55](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/styles/index.ts#L55)
 
 ___
 
@@ -3695,7 +3120,7 @@ Removes the dynamic theme block, returning to app-defined CSS values.
 
 #### Defined in
 
-[packages/core/src/theming/runtime.ts:86](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/theming/runtime.ts#L86)
+[packages/core/src/theming/runtime.ts:84](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/theming/runtime.ts#L84)
 
 ___
 
@@ -3718,7 +3143,7 @@ Use this in your SSR setup to avoid FOUC
 
 #### Defined in
 
-[packages/core/src/theming/runtime.ts:154](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/theming/runtime.ts#L154)
+[packages/core/src/theming/runtime.ts:139](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/theming/runtime.ts#L139)
 
 ___
 
@@ -3734,7 +3159,7 @@ Checks if dynamic theming is currently active
 
 #### Defined in
 
-[packages/core/src/theming/runtime.ts:161](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/theming/runtime.ts#L161)
+[packages/core/src/theming/runtime.ts:146](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/theming/runtime.ts#L146)
 
 ___
 
@@ -3751,7 +3176,7 @@ Useful for debugging or persistence
 
 #### Defined in
 
-[packages/core/src/theming/runtime.ts:173](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/theming/runtime.ts#L173)
+[packages/core/src/theming/runtime.ts:158](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/theming/runtime.ts#L158)
 
 ___
 
@@ -3855,7 +3280,7 @@ Create a secure data access instance
 
 | Name | Type | Default value | Description |
 | :------ | :------ | :------ | :------ |
-| `supabase` | `default`\<`any`, ``"public"``, ``"public"``, `any`, `any`\> | `undefined` | Supabase client instance |
+| `supabase` | `default`\<`any`, ``"public"``, `any`\> | `undefined` | Supabase client instance |
 | `organisationId` | `string` | `undefined` | Current organisation context |
 | `isSuperAdmin` | `boolean` | `false` | Whether user has super admin privileges |
 
@@ -3868,286 +3293,3 @@ Secure data access utilities
 #### Defined in
 
 [packages/core/src/utils/secureDataAccess.ts:66](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/utils/secureDataAccess.ts#L66)
-
-___
-
-### getFileSizeLimit
-
-▸ **getFileSizeLimit**(`mimeType`): `number`
-
-Get the file size limit for a given MIME type
-
-#### Parameters
-
-| Name | Type |
-| :------ | :------ |
-| `mimeType` | `string` |
-
-#### Returns
-
-`number`
-
-#### Defined in
-
-[packages/core/src/utils/storage/config.ts:63](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/utils/storage/config.ts#L63)
-
-___
-
-### validateFileSize
-
-▸ **validateFileSize**(`file`): `Object`
-
-Validate file size against limits
-
-#### Parameters
-
-| Name | Type |
-| :------ | :------ |
-| `file` | `File` |
-
-#### Returns
-
-`Object`
-
-| Name | Type |
-| :------ | :------ |
-| `isValid` | `boolean` |
-| `error?` | `string` |
-
-#### Defined in
-
-[packages/core/src/utils/storage/config.ts:70](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/utils/storage/config.ts#L70)
-
-___
-
-### formatFileSize
-
-▸ **formatFileSize**(`bytes`): `string`
-
-Get human-readable file size
-
-#### Parameters
-
-| Name | Type |
-| :------ | :------ |
-| `bytes` | `number` |
-
-#### Returns
-
-`string`
-
-#### Defined in
-
-[packages/core/src/utils/storage/config.ts:88](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/utils/storage/config.ts#L88)
-
-___
-
-### generateFilePath
-
-▸ **generateFilePath**(`options`, `fileName`): `string`
-
-Generate a file path based on app-first structure
-
-#### Parameters
-
-| Name | Type |
-| :------ | :------ |
-| `options` | [`StorageUploadOptions`](interfaces/StorageUploadOptions.md) |
-| `fileName` | `string` |
-
-#### Returns
-
-`string`
-
-#### Defined in
-
-[packages/core/src/utils/storage/helpers.ts:20](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/utils/storage/helpers.ts#L20)
-
-___
-
-### generateUniqueFileName
-
-▸ **generateUniqueFileName**(`originalName`): `string`
-
-Generate a unique filename with timestamp and UUID
-
-#### Parameters
-
-| Name | Type |
-| :------ | :------ |
-| `originalName` | `string` |
-
-#### Returns
-
-`string`
-
-#### Defined in
-
-[packages/core/src/utils/storage/helpers.ts:54](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/utils/storage/helpers.ts#L54)
-
-___
-
-### extractFileMetadata
-
-▸ **extractFileMetadata**(`file`, `options`, `uploadedBy`): `Promise`\<[`StorageFileMetadata`](interfaces/StorageFileMetadata.md)\>
-
-Extract file metadata from a File object
-
-#### Parameters
-
-| Name | Type |
-| :------ | :------ |
-| `file` | `File` |
-| `options` | [`StorageUploadOptions`](interfaces/StorageUploadOptions.md) |
-| `uploadedBy` | `string` |
-
-#### Returns
-
-`Promise`\<[`StorageFileMetadata`](interfaces/StorageFileMetadata.md)\>
-
-#### Defined in
-
-[packages/core/src/utils/storage/helpers.ts:66](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/utils/storage/helpers.ts#L66)
-
-___
-
-### uploadFile
-
-▸ **uploadFile**(`supabase`, `file`, `options`): `Promise`\<[`StorageUploadResult`](interfaces/StorageUploadResult.md)\>
-
-Upload a file to Supabase storage with app segregation
-
-#### Parameters
-
-| Name | Type |
-| :------ | :------ |
-| `supabase` | `default`\<`any`, ``"public"``, ``"public"``, `any`, `any`\> |
-| `file` | `File` |
-| `options` | [`StorageUploadOptions`](interfaces/StorageUploadOptions.md) |
-
-#### Returns
-
-`Promise`\<[`StorageUploadResult`](interfaces/StorageUploadResult.md)\>
-
-#### Defined in
-
-[packages/core/src/utils/storage/helpers.ts:140](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/utils/storage/helpers.ts#L140)
-
-___
-
-### getPublicUrl
-
-▸ **getPublicUrl**(`supabase`, `path`): `string`
-
-Get a public URL for a file
-
-#### Parameters
-
-| Name | Type |
-| :------ | :------ |
-| `supabase` | `default`\<`any`, ``"public"``, ``"public"``, `any`, `any`\> |
-| `path` | `string` |
-
-#### Returns
-
-`string`
-
-#### Defined in
-
-[packages/core/src/utils/storage/helpers.ts:205](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/utils/storage/helpers.ts#L205)
-
-___
-
-### getSignedUrl
-
-▸ **getSignedUrl**(`supabase`, `path`, `options`): `Promise`\<\{ `url`: `string` ; `expiresAt`: `string`  } \| ``null``\>
-
-Get a signed URL for a protected file
-
-#### Parameters
-
-| Name | Type |
-| :------ | :------ |
-| `supabase` | `default`\<`any`, ``"public"``, ``"public"``, `any`, `any`\> |
-| `path` | `string` |
-| `options` | [`StorageUrlOptions`](interfaces/StorageUrlOptions.md) |
-
-#### Returns
-
-`Promise`\<\{ `url`: `string` ; `expiresAt`: `string`  } \| ``null``\>
-
-#### Defined in
-
-[packages/core/src/utils/storage/helpers.ts:216](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/utils/storage/helpers.ts#L216)
-
-___
-
-### deleteFile
-
-▸ **deleteFile**(`supabase`, `path`): `Promise`\<\{ `success`: `boolean` ; `error?`: `string`  }\>
-
-Delete a file from storage
-
-#### Parameters
-
-| Name | Type |
-| :------ | :------ |
-| `supabase` | `default`\<`any`, ``"public"``, ``"public"``, `any`, `any`\> |
-| `path` | `string` |
-
-#### Returns
-
-`Promise`\<\{ `success`: `boolean` ; `error?`: `string`  }\>
-
-#### Defined in
-
-[packages/core/src/utils/storage/helpers.ts:244](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/utils/storage/helpers.ts#L244)
-
-___
-
-### listFiles
-
-▸ **listFiles**(`supabase`, `options`): `Promise`\<[`StorageListResult`](interfaces/StorageListResult.md)\>
-
-List files in an organization scope
-
-#### Parameters
-
-| Name | Type |
-| :------ | :------ |
-| `supabase` | `default`\<`any`, ``"public"``, ``"public"``, `any`, `any`\> |
-| `options` | [`StorageListOptions`](interfaces/StorageListOptions.md) |
-
-#### Returns
-
-`Promise`\<[`StorageListResult`](interfaces/StorageListResult.md)\>
-
-#### Defined in
-
-[packages/core/src/utils/storage/helpers.ts:272](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/utils/storage/helpers.ts#L272)
-
-___
-
-### archiveFile
-
-▸ **archiveFile**(`supabase`, `path`, `options`): `Promise`\<\{ `success`: `boolean` ; `error?`: `string`  }\>
-
-Move a file to archived location (soft delete)
-
-#### Parameters
-
-| Name | Type |
-| :------ | :------ |
-| `supabase` | `default`\<`any`, ``"public"``, ``"public"``, `any`, `any`\> |
-| `path` | `string` |
-| `options` | `Object` |
-| `options.appName` | `string` |
-| `options.orgId` | `string` |
-
-#### Returns
-
-`Promise`\<\{ `success`: `boolean` ; `error?`: `string`  }\>
-
-#### Defined in
-
-[packages/core/src/utils/storage/helpers.ts:325](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/utils/storage/helpers.ts#L325)