@jmruthers/pace-core 0.2.4

package/docs/api/modules.md

@@ -0,0 +1,4153 @@
+[@jmruthers/pace-core - v0.2.4](README.md) / Exports
+
+# @jmruthers/pace-core - v0.2.4
+
+**`File`**
+
+Complete Component Library Export
+
+**`Package`**
+
+@jmruthers/pace-core
+
+**`Since`**
+
+0.1.0
+
+This file exports the primary components, hooks, and utilities from the PACE Core library.
+It is the main entry point for developers using the library.
+
+**`Example`**
+
+```ts
+// Import common components
+import { Button, Card, useUnifiedAuth } from '@jmruthers/pace-core';
+
+// For specialized components, use the complete library import:
+import { Dialog, NavigationMenu } from '@jmruthers/pace-core/components';
+```
+
+## Table of contents
+
+### Classes
+
+- [ErrorBoundary](classes/ErrorBoundary.md)
+- [PublicErrorBoundary](classes/PublicErrorBoundary.md)
+
+### Interfaces
+
+- [ButtonProps](interfaces/ButtonProps.md)
+- [CardProps](interfaces/CardProps.md)
+- [DataTableProps](interfaces/DataTableProps.md)
+- [DataTableColumn](interfaces/DataTableColumn.md)
+- [DataTableAction](interfaces/DataTableAction.md)
+- [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)
+- [NavigationItem](interfaces/NavigationItem.md)
+- [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)
+- [UnifiedAuthContextType](interfaces/UnifiedAuthContextType.md)
+- [UnifiedAuthProviderProps](interfaces/UnifiedAuthProviderProps.md)
+- [StyleImport](interfaces/StyleImport.md)
+- [ColorShade](interfaces/ColorShade.md)
+- [ColorPalette](interfaces/ColorPalette.md)
+- [PaletteData](interfaces/PaletteData.md)
+- [Organisation](interfaces/Organisation.md)
+- [OrganisationMembership](interfaces/OrganisationMembership.md)
+- [UserProfile](interfaces/UserProfile.md)
+- [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
+
+- [DataRecord](modules.md#datarecord)
+- [GetRowId](modules.md#getrowid)
+
+### 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
+
+- [Alert](modules.md#alert)
+- [AlertTitle](modules.md#alerttitle)
+- [AlertDescription](modules.md#alertdescription)
+- [Avatar](modules.md#avatar)
+- [AvatarImage](modules.md#avatarimage)
+- [AvatarFallback](modules.md#avatarfallback)
+- [Button](modules.md#button)
+- [Card](modules.md#card)
+- [CardHeader](modules.md#cardheader)
+- [CardTitle](modules.md#cardtitle)
+- [CardDescription](modules.md#carddescription)
+- [CardContent](modules.md#cardcontent)
+- [CardFooter](modules.md#cardfooter)
+- [CardActions](modules.md#cardactions)
+- [Checkbox](modules.md#checkbox)
+- [DataTable](modules.md#datatable)
+- [Dialog](modules.md#dialog)
+- [DialogTrigger](modules.md#dialogtrigger)
+- [DialogPortal](modules.md#dialogportal)
+- [DialogClose](modules.md#dialogclose)
+- [DialogOverlay](modules.md#dialogoverlay)
+- [DialogContent](modules.md#dialogcontent)
+- [DialogHeader](modules.md#dialogheader)
+- [DialogBody](modules.md#dialogbody)
+- [DialogFooter](modules.md#dialogfooter)
+- [DialogTitle](modules.md#dialogtitle)
+- [DialogDescription](modules.md#dialogdescription)
+- [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)
+- [LoginForm](modules.md#loginform)
+- [NavigationMenu](modules.md#navigationmenu)
+- [OrganisationSelector](modules.md#organisationselector)
+- [PaceAppLayout](modules.md#paceapplayout)
+- [PaceLoginPage](modules.md#paceloginpage)
+- [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)
+- [SelectContent](modules.md#selectcontent)
+- [SelectItem](modules.md#selectitem)
+- [SelectGroup](modules.md#selectgroup)
+- [SelectLabel](modules.md#selectlabel)
+- [SelectSeparator](modules.md#selectseparator)
+- [Table](modules.md#table)
+- [TableHeader](modules.md#tableheader)
+- [TableBody](modules.md#tablebody)
+- [TableFooter](modules.md#tablefooter)
+- [TableRow](modules.md#tablerow)
+- [TableHead](modules.md#tablehead)
+- [TableCell](modules.md#tablecell)
+- [TableCaption](modules.md#tablecaption)
+- [ToastProvider](modules.md#toastprovider)
+- [ToastViewport](modules.md#toastviewport)
+- [Toast](modules.md#toast)
+- [ToastAction](modules.md#toastaction)
+- [ToastClose](modules.md#toastclose)
+- [ToastTitle](modules.md#toasttitle)
+- [ToastDescription](modules.md#toastdescription)
+- [useToast](modules.md#usetoast)
+- [Toaster](modules.md#toaster)
+- [TooltipProvider](modules.md#tooltipprovider)
+- [TooltipRoot](modules.md#tooltiproot)
+- [TooltipTrigger](modules.md#tooltiptrigger)
+- [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)
+- [useOrganisations](modules.md#useorganisations)
+- [useUnifiedAuth](modules.md#useunifiedauth)
+- [UnifiedAuthProvider](modules.md#unifiedauthprovider)
+- [getStylePath](modules.md#getstylepath)
+- [getAllStylePaths](modules.md#getallstylepaths)
+- [applyPalette](modules.md#applypalette)
+- [clearPalette](modules.md#clearpalette)
+- [generateSSRThemeCSS](modules.md#generatessrthemecss)
+- [isDynamicThemingActive](modules.md#isdynamicthemingactive)
+- [getCurrentThemeData](modules.md#getcurrentthemedata)
+- [setAppConfig](modules.md#setappconfig)
+- [getAppConfig](modules.md#getappconfig)
+- [getCurrentAppName](modules.md#getcurrentappname)
+- [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
+
+### DataRecord
+
+Ƭ **DataRecord**: `Record`\<`string`, `any`\>
+
+Generic data record type - all DataTable data must extend this
+
+#### Defined in
+
+[packages/core/src/components/DataTable/types.ts:27](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/DataTable/types.ts#L27)
+
+___
+
+### GetRowId
+
+Ƭ **GetRowId**\<`TData`\>: (`row`: `TData`, `index`: `number`) => `string`
+
+Row identifier function type
+
+#### Type parameters
+
+| Name | Type |
+| :------ | :------ |
+| `TData` | extends [`DataRecord`](modules.md#datarecord) |
+
+#### Type declaration
+
+▸ (`row`, `index`): `string`
+
+##### Parameters
+
+| Name | Type |
+| :------ | :------ |
+| `row` | `TData` |
+| `index` | `number` |
+
+##### Returns
+
+`string`
+
+#### Defined in
+
+[packages/core/src/components/DataTable/types.ts:32](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/DataTable/types.ts#L32)
+
+## Variables
+
+### styleConfig
+
+• `Const` **styleConfig**: `Object`
+
+#### Type declaration
+
+| 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"`` |
+
+#### 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)
+
+## Functions
+
+### Alert
+
+▸ **Alert**(`props`): `ReactNode`
+
+#### Parameters
+
+| Name | Type |
+| :------ | :------ |
+| `props` | `HTMLAttributes`\<`HTMLDivElement`\> & \{ `variant?`: ``"destructive"`` \| ``"default"`` \| ``"inline"``  } & `RefAttributes`\<`HTMLDivElement`\> |
+
+#### Returns
+
+`ReactNode`
+
+#### Defined in
+
+[packages/core/src/components/Alert/Alert.tsx:67](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Alert/Alert.tsx#L67)
+
+___
+
+### AlertTitle
+
+▸ **AlertTitle**(`props`): `ReactNode`
+
+#### Parameters
+
+| Name | Type |
+| :------ | :------ |
+| `props` | `HTMLAttributes`\<`HTMLHeadingElement`\> & `RefAttributes`\<`HTMLParagraphElement`\> |
+
+#### Returns
+
+`ReactNode`
+
+#### Defined in
+
+[packages/core/src/components/Alert/Alert.tsx:94](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Alert/Alert.tsx#L94)
+
+___
+
+### AlertDescription
+
+▸ **AlertDescription**(`props`): `ReactNode`
+
+#### Parameters
+
+| Name | Type |
+| :------ | :------ |
+| `props` | `HTMLAttributes`\<`HTMLParagraphElement`\> & `RefAttributes`\<`HTMLParagraphElement`\> |
+
+#### Returns
+
+`ReactNode`
+
+#### Defined in
+
+[packages/core/src/components/Alert/Alert.tsx:114](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Alert/Alert.tsx#L114)
+
+___
+
+### Avatar
+
+▸ **Avatar**(`props`): `ReactNode`
+
+#### Parameters
+
+| Name | Type |
+| :------ | :------ |
+| `props` | `Omit`\<`AvatarProps` & `RefAttributes`\<`HTMLSpanElement`\>, ``"ref"``\> & `RefAttributes`\<`HTMLSpanElement`\> |
+
+#### Returns
+
+`ReactNode`
+
+#### Defined in
+
+[packages/core/src/components/Avatar/Avatar.tsx:42](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Avatar/Avatar.tsx#L42)
+
+___
+
+### AvatarImage
+
+▸ **AvatarImage**(`props`): `ReactNode`
+
+#### Parameters
+
+| Name | Type |
+| :------ | :------ |
+| `props` | `Omit`\<`AvatarImageProps` & `RefAttributes`\<`HTMLImageElement`\>, ``"ref"``\> & `RefAttributes`\<`HTMLImageElement`\> |
+
+#### Returns
+
+`ReactNode`
+
+#### Defined in
+
+[packages/core/src/components/Avatar/Avatar.tsx:57](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Avatar/Avatar.tsx#L57)
+
+___
+
+### AvatarFallback
+
+▸ **AvatarFallback**(`props`): `ReactNode`
+
+#### Parameters
+
+| Name | Type |
+| :------ | :------ |
+| `props` | `Omit`\<`AvatarFallbackProps` & `RefAttributes`\<`HTMLSpanElement`\>, ``"ref"``\> & `RefAttributes`\<`HTMLSpanElement`\> |
+
+#### Returns
+
+`ReactNode`
+
+#### Defined in
+
+[packages/core/src/components/Avatar/Avatar.tsx:69](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Avatar/Avatar.tsx#L69)
+
+___
+
+### Button
+
+▸ **Button**(`props`): `ReactNode`
+
+Button Component
+A flexible, accessible button component with multiple variants and sizes.
+
+#### Parameters
+
+| Name | Type |
+| :------ | :------ |
+| `props` | [`ButtonProps`](interfaces/ButtonProps.md) & `RefAttributes`\<`HTMLButtonElement`\> |
+
+#### Returns
+
+`ReactNode`
+
+**`Component`**
+
+**`Example`**
+
+```tsx
+// Basic button
+<Button>Click me</Button>
+
+// Button with variant and size
+<Button variant="destructive" size="lg">Delete</Button>
+
+// Button as child (composition)
+<Button asChild>
+  <Link href="/dashboard">Go to Dashboard</Link>
+</Button>
+```
+
+#### Defined in
+
+[packages/core/src/components/Button/Button.tsx:109](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Button/Button.tsx#L109)
+
+___
+
+### Card
+
+▸ **Card**(`props`): `ReactNode`
+
+#### Parameters
+
+| Name | Type |
+| :------ | :------ |
+| `props` | [`CardProps`](interfaces/CardProps.md) & `RefAttributes`\<`HTMLElement`\> |
+
+#### Returns
+
+`ReactNode`
+
+#### Defined in
+
+[packages/core/src/components/Card/Card.tsx:95](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Card/Card.tsx#L95)
+
+___
+
+### CardHeader
+
+▸ **CardHeader**(`props`): `ReactNode`
+
+#### Parameters
+
+| Name | Type |
+| :------ | :------ |
+| `props` | `HTMLAttributes`\<`HTMLElement`\> & `RefAttributes`\<`HTMLElement`\> |
+
+#### Returns
+
+`ReactNode`
+
+#### Defined in
+
+[packages/core/src/components/Card/Card.tsx:111](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Card/Card.tsx#L111)
+
+___
+
+### CardTitle
+
+▸ **CardTitle**(`props`): `ReactNode`
+
+#### Parameters
+
+| Name | Type |
+| :------ | :------ |
+| `props` | `HTMLAttributes`\<`HTMLHeadingElement`\> & `RefAttributes`\<`HTMLHeadingElement`\> |
+
+#### Returns
+
+`ReactNode`
+
+#### Defined in
+
+[packages/core/src/components/Card/Card.tsx:123](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Card/Card.tsx#L123)
+
+___
+
+### CardDescription
+
+▸ **CardDescription**(`props`): `ReactNode`
+
+#### Parameters
+
+| Name | Type |
+| :------ | :------ |
+| `props` | `HTMLAttributes`\<`HTMLParagraphElement`\> & `RefAttributes`\<`HTMLParagraphElement`\> |
+
+#### Returns
+
+`ReactNode`
+
+#### Defined in
+
+[packages/core/src/components/Card/Card.tsx:138](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Card/Card.tsx#L138)
+
+___
+
+### CardContent
+
+▸ **CardContent**(`props`): `ReactNode`
+
+#### Parameters
+
+| Name | Type |
+| :------ | :------ |
+| `props` | `HTMLAttributes`\<`HTMLElement`\> & `RefAttributes`\<`HTMLElement`\> |
+
+#### Returns
+
+`ReactNode`
+
+#### Defined in
+
+[packages/core/src/components/Card/Card.tsx:150](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Card/Card.tsx#L150)
+
+___
+
+### CardFooter
+
+▸ **CardFooter**(`props`): `ReactNode`
+
+#### Parameters
+
+| Name | Type |
+| :------ | :------ |
+| `props` | `HTMLAttributes`\<`HTMLElement`\> & `RefAttributes`\<`HTMLElement`\> |
+
+#### Returns
+
+`ReactNode`
+
+#### Defined in
+
+[packages/core/src/components/Card/Card.tsx:162](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Card/Card.tsx#L162)
+
+___
+
+### CardActions
+
+▸ **CardActions**(`props`): `ReactNode`
+
+#### Parameters
+
+| Name | Type |
+| :------ | :------ |
+| `props` | `HTMLAttributes`\<`HTMLParagraphElement`\> & `RefAttributes`\<`HTMLParagraphElement`\> |
+
+#### Returns
+
+`ReactNode`
+
+#### Defined in
+
+[packages/core/src/components/Card/Card.tsx:174](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Card/Card.tsx#L174)
+
+___
+
+### Checkbox
+
+▸ **Checkbox**(`props`): `ReactNode`
+
+#### Parameters
+
+| Name | Type |
+| :------ | :------ |
+| `props` | `Omit`\<`CheckboxProps` & `RefAttributes`\<`HTMLButtonElement`\>, ``"ref"``\> & `RefAttributes`\<`HTMLButtonElement`\> |
+
+#### Returns
+
+`ReactNode`
+
+#### Defined in
+
+[packages/core/src/components/Checkbox/Checkbox.tsx:54](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Checkbox/Checkbox.tsx#L54)
+
+___
+
+### DataTable
+
+▸ **DataTable**\<`TData`\>(`props`): `Element`
+
+Enhanced DataTable with comprehensive performance optimizations
+
+This component automatically detects dataset size and applies appropriate performance optimizations:
+- < 1,000 records: Standard rendering with full feature support
+- 1,000+ records: Automatic virtual scrolling with intelligent memory management
+- 10,000+ records: Enhanced chunking and memory optimization
+- 100,000+ records: Advanced server-side processing with virtualization
+
+Features are configured through the unified `features` prop for maximum flexibility.
+
+#### Type parameters
+
+| Name | Type |
+| :------ | :------ |
+| `TData` | extends [`DataRecord`](modules.md#datarecord) |
+
+#### Parameters
+
+| Name | Type |
+| :------ | :------ |
+| `props` | [`DataTableProps`](interfaces/DataTableProps.md)\<`TData`\> |
+
+#### Returns
+
+`Element`
+
+#### Defined in
+
+[packages/core/src/components/DataTable/DataTable.tsx:414](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/DataTable/DataTable.tsx#L414)
+
+___
+
+### Dialog
+
+▸ **Dialog**(`props`, `deprecatedLegacyContext?`): `ReactNode`
+
+#### Parameters
+
+| Name | Type | Description |
+| :------ | :------ | :------ |
+| `props` | `DialogProps` | - |
+| `deprecatedLegacyContext?` | `any` | **`See`** [React Docs](https://legacy.reactjs.org/docs/legacy-context.html#referencing-context-in-lifecycle-methods) |
+
+#### Returns
+
+`ReactNode`
+
+#### 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)
+
+___
+
+### DialogTrigger
+
+▸ **DialogTrigger**(`props`): `ReactNode`
+
+#### Parameters
+
+| Name | Type |
+| :------ | :------ |
+| `props` | `DialogTriggerProps` & `RefAttributes`\<`HTMLButtonElement`\> |
+
+#### Returns
+
+`ReactNode`
+
+#### 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)
+
+___
+
+### DialogPortal
+
+▸ **DialogPortal**(`props`, `deprecatedLegacyContext?`): `ReactNode`
+
+#### Parameters
+
+| Name | Type | Description |
+| :------ | :------ | :------ |
+| `props` | `DialogPortalProps` | - |
+| `deprecatedLegacyContext?` | `any` | **`See`** [React Docs](https://legacy.reactjs.org/docs/legacy-context.html#referencing-context-in-lifecycle-methods) |
+
+#### Returns
+
+`ReactNode`
+
+#### 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)
+
+___
+
+### DialogClose
+
+▸ **DialogClose**(`props`): `ReactNode`
+
+#### Parameters
+
+| Name | Type |
+| :------ | :------ |
+| `props` | `DialogCloseProps` & `RefAttributes`\<`HTMLButtonElement`\> |
+
+#### Returns
+
+`ReactNode`
+
+#### 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)
+
+___
+
+### DialogOverlay
+
+▸ **DialogOverlay**(`props`): `ReactNode`
+
+#### Parameters
+
+| Name | Type |
+| :------ | :------ |
+| `props` | `DialogOverlayProps` & `RefAttributes`\<`HTMLDivElement`\> |
+
+#### Returns
+
+`ReactNode`
+
+#### 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)
+
+___
+
+### DialogContent
+
+▸ **DialogContent**(`props`): `ReactNode`
+
+DialogContent component
+The main content container using semantic HTML <dialog> element with enhanced features
+Built on Radix UI primitives for accessibility while providing semantic structure
+
+#### Parameters
+
+| Name | Type | Description |
+| :------ | :------ | :------ |
+| `props` | `DialogContentProps` & `RefAttributes`\<`HTMLDivElement`\> | Content configuration and styling |
+
+#### Returns
+
+`ReactNode`
+
+JSX.Element - The semantic dialog content with overlay and optional close button
+
+**`Example`**
+
+```tsx
+<DialogContent size="lg" enableScrolling={true} maxHeightPercent={80}>
+  <DialogHeader>
+    <DialogTitle>Scrollable Dialog</DialogTitle>
+    <DialogDescription>This dialog will scroll if content overflows.</DialogDescription>
+  </DialogHeader>
+  <DialogBody>
+    <section>Large amount of semantic content here...</section>
+  </DialogBody>
+  <DialogFooter>
+    <Button>Save</Button>
+  </DialogFooter>
+</DialogContent>
+```
+
+#### 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)
+
+___
+
+### DialogHeader
+
+▸ **DialogHeader**(`props`): `Element`
+
+DialogHeader component
+Semantic header container for dialog title and description with optional sticky behavior
+
+#### Parameters
+
+| Name | Type | Description |
+| :------ | :------ | :------ |
+| `props` | `DialogHeaderProps` | Header configuration and styling |
+
+#### Returns
+
+`Element`
+
+JSX.Element - The dialog header container using semantic <header> element
+
+**`Example`**
+
+```tsx
+<DialogHeader sticky={true}>
+  <DialogTitle>Sticky Header</DialogTitle>
+  <DialogDescription>This header stays visible while scrolling.</DialogDescription>
+</DialogHeader>
+```
+
+#### 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)
+
+___
+
+### DialogBody
+
+▸ **DialogBody**(`props`): `Element`
+
+DialogBody component
+Semantic main content area for dialog body content with scrollable functionality
+Supports both React children and safe HTML content rendering
+
+#### Parameters
+
+| Name | Type | Description |
+| :------ | :------ | :------ |
+| `props` | `DialogBodyProps` | Body configuration and styling |
+
+#### Returns
+
+`Element`
+
+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)
+
+___
+
+### DialogFooter
+
+▸ **DialogFooter**(`props`): `Element`
+
+DialogFooter component
+Semantic footer container for dialog action buttons with optional sticky behavior
+
+#### Parameters
+
+| Name | Type | Description |
+| :------ | :------ | :------ |
+| `props` | `DialogFooterProps` | Footer configuration and styling |
+
+#### Returns
+
+`Element`
+
+JSX.Element - The dialog footer container using semantic <footer> element
+
+**`Example`**
+
+```tsx
+<DialogFooter sticky={true}>
+  <Button variant="outline">Cancel</Button>
+  <Button>Save changes</Button>
+</DialogFooter>
+```
+
+#### 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)
+
+___
+
+### DialogTitle
+
+▸ **DialogTitle**(`props`): `ReactNode`
+
+#### Parameters
+
+| Name | Type |
+| :------ | :------ |
+| `props` | `DialogTitleProps` & `RefAttributes`\<`HTMLHeadingElement`\> |
+
+#### Returns
+
+`ReactNode`
+
+#### 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)
+
+___
+
+### DialogDescription
+
+▸ **DialogDescription**(`props`): `ReactNode`
+
+#### Parameters
+
+| Name | Type |
+| :------ | :------ |
+| `props` | `DialogDescriptionProps` & `RefAttributes`\<`HTMLParagraphElement`\> |
+
+#### Returns
+
+`ReactNode`
+
+#### 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)
+
+___
+
+### EventSelector
+
+▸ **EventSelector**(`«destructured»`): ``null`` \| `Element`
+
+EventSelector component for selecting events with built-in access control
+
+This component provides secure event selection with:
+- Database integration via rbac_event_app_roles table
+- Auto-selection of next upcoming event by date
+- Cross-device sync via Supabase user session metadata
+- localStorage fallback for offline scenarios
+- Comprehensive error handling and user feedback
+
+#### Parameters
+
+| Name | Type |
+| :------ | :------ |
+| `«destructured»` | `EventSelectorProps` |
+
+#### Returns
+
+``null`` \| `Element`
+
+**`Component`**
+
+**`Example`**
+
+```ts
+<UnifiedAuthProvider supabaseClient={supabase} appName="PACE">
+  <EventSelector onEventChange={(event) => console.log(event)} />
+</UnifiedAuthProvider>
+```
+
+#### 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)
+
+___
+
+### FileUpload
+
+▸ **FileUpload**(`«destructured»`): `Element`
+
+#### Parameters
+
+| Name | Type |
+| :------ | :------ |
+| `«destructured»` | [`FileUploadProps`](interfaces/FileUploadProps.md) |
+
+#### Returns
+
+`Element`
+
+#### 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)
+
+___
+
+### Footer
+
+▸ **Footer**(`props`): `ReactNode`
+
+#### Parameters
+
+| Name | Type |
+| :------ | :------ |
+| `props` | [`FooterProps`](interfaces/FooterProps.md) |
+
+#### Returns
+
+`ReactNode`
+
+#### 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)
+
+___
+
+### Form
+
+▸ **Form**\<`TFieldValues`\>(`props`): `Element`
+
+Form component with validation and React Hook Form integration
+
+#### Type parameters
+
+| Name | Type | Description |
+| :------ | :------ | :------ |
+| `TFieldValues` | extends `FieldValues` = `FieldValues` | The type of form field values |
+
+#### Parameters
+
+| Name | Type | Description |
+| :------ | :------ | :------ |
+| `props` | `FormProps`\<`TFieldValues`\> | Form configuration and handlers |
+
+#### 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>
+```
+
+#### 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)
+
+___
+
+### 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.
+
+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` | `HeaderProps` | Header configuration including logo, navigation, user settings, and custom content |
+
+#### 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' }
+  ];
+
+  return (
+    <Header
+      logoUrl="/company-logo.svg"
+      logoAlt="My Company"
+      navItems={navItems}
+      currentPath={location.pathname}
+      onNavigate={(item) => navigate(item.href)}
+      user={currentUser}
+      onSignOut={handleSignOut}
+    />
+  );
+}
+```
+
+**`Example`**
+
+Header with custom actions:
+```tsx
+import { Header, Button } from '@jmruthers/pace-core';
+
+function HeaderWithActions() {
+  const customActions = (
+    <div className="flex items-center gap-2">
+      <Button variant="outline" size="sm">Export</Button>
+      <Button size="sm">New Item</Button>
+    </div>
+  );
+
+  return (
+    <Header
+      logoUrl="/logo.svg"
+      navItems={navigationItems}
+      actions={customActions}
+      user={currentUser}
+      onSignOut={handleSignOut}
+    />
+  );
+}
+```
+
+**`Example`**
+
+Minimal header configuration:
+```tsx
+function MinimalHeader() {
+  return (
+    <Header
+      logoUrl="/simple-logo.svg"
+      logoAlt="Simple App"
+      showEventSelector={false}
+      user={currentUser}
+      onSignOut={handleSignOut}
+    />
+  );
+}
+```
+
+**`Since`**
+
+0.1.0
+
+#### 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)
+
+___
+
+### InactivityWarningModal
+
+▸ **InactivityWarningModal**(`«destructured»`): `Element`
+
+#### Parameters
+
+| Name | Type |
+| :------ | :------ |
+| `«destructured»` | [`InactivityWarningModalProps`](interfaces/InactivityWarningModalProps.md) |
+
+#### Returns
+
+`Element`
+
+#### 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)
+
+___
+
+### Input
+
+▸ **Input**(`props`): `ReactNode`
+
+Input component
+A flexible, accessible input component with multiple variants and sizes
+
+#### Parameters
+
+| Name | Type | Description |
+| :------ | :------ | :------ |
+| `props` | [`InputProps`](interfaces/InputProps.md) & `RefAttributes`\<`HTMLInputElement`\> | Input configuration and styling |
+
+#### Returns
+
+`ReactNode`
+
+JSX.Element - The rendered input element
+
+**`Example`**
+
+```tsx
+// Basic input
+<Input placeholder="Enter your name" />
+
+// Input with error state
+<Input 
+  placeholder="Email" 
+  type="email" 
+  error={true}
+/>
+
+// Large input with destructive variant
+<Input 
+  variant="destructive" 
+  size="lg" 
+  placeholder="Error input" 
+/>
+```
+
+#### 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)
+
+___
+
+### Label
+
+▸ **Label**(`props`): `ReactNode`
+
+Label component
+An accessible label with helper text and error state support
+
+#### Parameters
+
+| Name | Type | Description |
+| :------ | :------ | :------ |
+| `props` | [`LabelProps`](interfaces/LabelProps.md) & `RefAttributes`\<`HTMLLabelElement`\> | Label configuration and styling |
+
+#### Returns
+
+`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/Label/Label.tsx:120](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Label/Label.tsx#L120)
+
+___
+
+### LoadingSpinner
+
+▸ **LoadingSpinner**(`props`, `deprecatedLegacyContext?`): `ReactNode`
+
+LoadingSpinner component
+A simple, accessible loading spinner for indicating loading states
+
+#### 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) |
+
+#### Returns
+
+`ReactNode`
+
+JSX.Element - The rendered loading spinner
+
+**`Example`**
+
+```tsx
+<LoadingSpinner size="lg" className="text-main-500" />
+```
+
+#### 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)
+
+___
+
+### LoginForm
+
+▸ **LoginForm**(`props`): `ReactNode`
+
+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 | Description |
+| :------ | :------ | :------ |
+| `props` | [`LoginFormProps`](interfaces/LoginFormProps.md) | Login form configuration and handlers |
+
+#### 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)
+
+___
+
+### 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.
+
+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 | Description |
+| :------ | :------ | :------ |
+| `props` | [`NavigationMenuProps`](interfaces/NavigationMenuProps.md) & `RefAttributes`\<`HTMLDivElement`\> | NavigationMenu component props including items, mode, navigation handlers, and styling options |
+
+#### 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' }
+  ];
+
+  return (
+    <NavigationMenu 
+      items={navItems}
+      mode="dropdown"
+      currentPath={location.pathname}
+      onNavigate={(item) => navigate(item.href)}
+      buttonText="Main Menu"
+      showIcons={true}
+    />
+  );
+}
+```
+
+**`Example`**
+
+Hierarchical navigation with nested items:
+```tsx
+import { NavigationMenu } from '@jmruthers/pace-core';
+
+function SidebarNavigation() {
+  const hierarchicalItems = [
+    { 
+      id: 'user-management', 
+      label: 'User Management',
+      icon: 'Users',
+      children: [
+        { id: 'users-list', label: 'All Users', href: '/users' },
+        { id: 'users-create', label: 'Create User', href: '/users/create' },
+        { id: 'user-roles', label: 'User Roles', href: '/users/roles' }
+      ]
+    },
+    { 
+      id: 'reports', 
+      label: 'Reports',
+      icon: 'BarChart',
+      children: [
+        { id: 'sales-reports', label: 'Sales Reports', href: '/reports/sales' },
+        { id: 'user-reports', label: 'User Reports', href: '/reports/users' }
+      ]
+    },
+    { id: 'settings', label: 'Settings', href: '/settings', icon: 'Settings' }
+  ];
+
+  return (
+    <NavigationMenu 
+      items={hierarchicalItems}
+      mode="hierarchical"
+      currentPath={window.location.pathname}
+      onNavigate={(item) => {
+        if (item.href) {
+          window.location.href = item.href;
+        }
+      }}
+      className="w-64 bg-sec-50 p-4"
+    />
+  );
+}
+```
+
+**`Example`**
+
+Integration with React Router and authentication:
+```tsx
+import { NavigationMenu } from '@jmruthers/pace-core';
+import { useNavigate, useLocation } from 'react-router-dom';
+import { useUnifiedAuth } from '@jmruthers/pace-core/providers';
+
+function AuthenticatedNavigation() {
+  const navigate = useNavigate();
+  const location = useLocation();
+  const { hasRole, hasPermission } = useUnifiedAuth();
+
+  // Build navigation items with permission requirements
+  const navItems = [
+    { 
+      id: 'dashboard', 
+      label: 'Dashboard', 
+      href: '/dashboard', 
+      icon: 'LayoutDashboard',
+      permissions: ['dashboard:read']
+    },
+    { 
+      id: 'meals', 
+      label: 'Meals', 
+      href: '/meals', 
+      icon: 'UtensilsCrossed',
+      permissions: ['meals:read']
+    },
+    { 
+      id: 'admin', 
+      label: 'Admin Panel', 
+      href: '/admin', 
+      icon: 'Shield',
+      roles: ['admin', 'super_admin']
+    },
+    { 
+      id: 'profile', 
+      label: 'Profile', 
+      href: '/profile', 
+      icon: 'User'
+    }
+  ];
+
+  return (
+    <NavigationMenu 
+      items={navItems}
+      mode="dropdown"
+      currentPath={location.pathname}
+      onNavigate={(item) => navigate(item.href)}
+      buttonText="Navigation"
+      navigationLabel="Main application navigation"
+      filterByPermissions={true}
+      auditLog={true}
+    />
+  );
+}
+```
+
+**`Example`**
+
+Custom navigation with external links and actions:
+```tsx
+import { NavigationMenu } from '@jmruthers/pace-core';
+
+function CustomNavigation() {
+  const handleNavigation = (item) => {
+    if (item.id === 'logout') {
+      // Handle logout action
+      handleLogout();
+    } else if (item.href?.startsWith('http')) {
+      // Handle external links
+      window.open(item.href, '_blank');
+    } else if (item.href) {
+      // Handle internal navigation
+      navigate(item.href);
+    }
+  };
+
+  const navItems = [
+    { id: 'home', label: 'Home', href: '/', icon: 'Home' },
+    { id: 'help', label: 'Help Center', href: 'https://help.example.com', icon: 'HelpCircle' },
+    { id: 'logout', label: 'Sign Out', icon: 'LogOut' } // No href for actions
+  ];
+
+  return (
+    <NavigationMenu 
+      items={navItems}
+      mode="dropdown"
+      onNavigate={handleNavigation}
+      buttonText="Menu"
+      disabled={false}
+    />
+  );
+}
+```
+
+**`Since`**
+
+0.1.0
+
+#### 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)
+
+___
+
+### 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
+
+Security: Only shows organisations the user has valid access to
+
+#### Parameters
+
+| Name | Type |
+| :------ | :------ |
+| `«destructured»` | `OrganisationSelectorProps` |
+
+#### Returns
+
+``null`` \| `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)
+
+___
+
+### 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.
+
+NEW: This component now includes layout-level permission enforcement to ensure
+consuming apps can't forget to implement permission checks on individual pages.
+
+This component is designed to work with React Router's nested routing pattern using
+Outlet to render child routes. It provides integrated authentication, navigation,
+and user management functionality.
+
+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` | [`PaceAppLayoutProps`](interfaces/PaceAppLayoutProps.md) | Layout configuration including app name for branding and permission settings |
+
+#### Returns
+
+`Element`
+
+React element with complete application layout structure and permission enforcement
+
+**`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" 
+/>
+```
+
+#### 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)
+
+___
+
+### PasswordChangeForm
+
+▸ **PasswordChangeForm**(`«destructured»`): `Element`
+
+#### Parameters
+
+| Name | Type |
+| :------ | :------ |
+| `«destructured»` | `PasswordChangeFormProps` |
+
+#### Returns
+
+`Element`
+
+#### 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)
+
+___
+
+### 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)
+
+___
+
+### Progress
+
+▸ **Progress**(`props`): `ReactNode`
+
+Progress component
+An accessible progress bar with smooth animations
+
+#### Parameters
+
+| Name | Type | Description |
+| :------ | :------ | :------ |
+| `props` | `ProgressProps` & `RefAttributes`\<`HTMLDivElement`\> | Progress configuration and styling |
+
+#### Returns
+
+`ReactNode`
+
+JSX.Element - The rendered progress bar
+
+**`Example`**
+
+```tsx
+<Progress value={75} max={100} />
+```
+
+#### 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)
+
+___
+
+### EventLogo
+
+▸ **EventLogo**(`props`): ``null`` \| `Element`
+
+Component for displaying event logos with fallback to initials
+
+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.
+
+#### Parameters
+
+| Name | Type | Description |
+| :------ | :------ | :------ |
+| `props` | [`EventLogoProps`](interfaces/EventLogoProps.md) | Logo configuration and styling |
+
+#### Returns
+
+``null`` \| `Element`
+
+React element with event logo or fallback
+
+#### Defined in
+
+[packages/core/src/components/PublicLayout/EventLogo.tsx:111](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/PublicLayout/EventLogo.tsx#L111)
+
+___
+
+### EventLogoCompact
+
+▸ **EventLogoCompact**(`props`): `Element`
+
+Compact event logo for small spaces
+
+#### Parameters
+
+| Name | Type |
+| :------ | :------ |
+| `props` | [`EventLogoProps`](interfaces/EventLogoProps.md) |
+
+#### Returns
+
+`Element`
+
+#### 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)
+
+___
+
+### EventLogoLarge
+
+▸ **EventLogoLarge**(`props`): `Element`
+
+Large event logo for prominent display
+
+#### Parameters
+
+| Name | Type |
+| :------ | :------ |
+| `props` | [`EventLogoProps`](interfaces/EventLogoProps.md) |
+
+#### 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
+
+▸ **useErrorBoundary**(): `Object`
+
+Hook for accessing error boundary state
+Useful for components that need to know if they're inside an error boundary
+
+#### Returns
+
+`Object`
+
+| Name | Type |
+| :------ | :------ |
+| `captureError` | (`error`: `Error`) => `void` |
+| `resetError` | () => `void` |
+
+#### 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)
+
+___
+
+### DefaultPublicErrorFallback
+
+▸ **DefaultPublicErrorFallback**(`«destructured»`): `Element`
+
+Default error fallback component
+
+#### Parameters
+
+| Name | Type |
+| :------ | :------ |
+| `«destructured»` | [`PublicErrorBoundaryState`](interfaces/PublicErrorBoundaryState.md) |
+
+#### Returns
+
+`Element`
+
+#### 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)
+
+___
+
+### PublicLoadingSpinner
+
+▸ **PublicLoadingSpinner**(`props`): `Element`
+
+Loading spinner component for public pages
+
+This component displays a consistent loading state with optional
+branding and messaging for public pages.
+
+#### Parameters
+
+| Name | Type | Description |
+| :------ | :------ | :------ |
+| `props` | [`PublicLoadingSpinnerProps`](interfaces/PublicLoadingSpinnerProps.md) | Spinner configuration and styling |
+
+#### Returns
+
+`Element`
+
+React element with loading spinner
+
+#### 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)
+
+___
+
+### PublicLoadingSpinnerFullPage
+
+▸ **PublicLoadingSpinnerFullPage**(`«destructured»`): `Element`
+
+Full page loading spinner with event branding
+
+#### Parameters
+
+| Name | Type |
+| :------ | :------ |
+| `«destructured»` | `Pick`\<[`PublicLoadingSpinnerProps`](interfaces/PublicLoadingSpinnerProps.md), ``"message"`` \| ``"className"``\> & \{ `eventName?`: `string`  } |
+
+#### Returns
+
+`Element`
+
+#### 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)
+
+___
+
+### PublicLoadingSkeleton
+
+▸ **PublicLoadingSkeleton**(`«destructured»`): `Element`
+
+Skeleton loading component for content placeholders
+
+#### Parameters
+
+| Name | Type | Default value |
+| :------ | :------ | :------ |
+| `«destructured»` | `Object` | `undefined` |
+| › `lines?` | `number` | `3` |
+| › `className?` | `string` | `''` |
+
+#### Returns
+
+`Element`
+
+#### Defined in
+
+[packages/core/src/components/PublicLayout/PublicLoadingSpinner.tsx:189](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/PublicLayout/PublicLoadingSpinner.tsx#L189)
+
+___
+
+### PublicPageContextChecker
+
+▸ **PublicPageContextChecker**(`«destructured»`): ``null`` \| `Element`
+
+Context checker component that immediately identifies authentication context issues
+
+This component will immediately log to console if authentication context
+is being triggered in a public page.
+
+#### Parameters
+
+| Name | Type |
+| :------ | :------ |
+| `«destructured»` | `PublicPageContextCheckerProps` |
+
+#### Returns
+
+``null`` \| `Element`
+
+#### Defined in
+
+[packages/core/src/components/PublicLayout/PublicPageContextChecker.tsx:27](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/PublicLayout/PublicPageContextChecker.tsx#L27)
+
+___
+
+### PublicPageDebugger
+
+▸ **PublicPageDebugger**(`«destructured»`): ``null`` \| `Element`
+
+Debugger component that logs context information
+
+This component helps identify why authentication context
+is being triggered in public pages.
+
+#### Parameters
+
+| Name | Type |
+| :------ | :------ |
+| `«destructured»` | `PublicPageDebuggerProps` |
+
+#### Returns
+
+``null`` \| `Element`
+
+#### 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)
+
+___
+
+### PublicPageDiagnostic
+
+▸ **PublicPageDiagnostic**(`«destructured»`): ``null`` \| `Element`
+
+Diagnostic component that identifies authentication context issues
+
+This component will help you identify exactly where the problem is
+in your public page implementation.
+
+#### Parameters
+
+| Name | Type |
+| :------ | :------ |
+| `«destructured»` | `PublicPageDiagnosticProps` |
+
+#### Returns
+
+``null`` \| `Element`
+
+#### 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)
+
+___
+
+### PublicPageFooter
+
+▸ **PublicPageFooter**(`props`): `Element`
+
+Footer component for public pages that matches the normal Footer exactly
+
+This component uses the same styling and structure as the main Footer component
+to ensure consistency across the application.
+
+#### Parameters
+
+| Name | Type | Description |
+| :------ | :------ | :------ |
+| `props` | [`PublicPageFooterProps`](interfaces/PublicPageFooterProps.md) | Footer configuration and content |
+
+#### Returns
+
+`Element`
+
+React element with public page footer
+
+#### 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)
+
+___
+
+### PublicPageHeader
+
+▸ **PublicPageHeader**(`props`): `Element`
+
+Header component for public pages with event-specific branding
+
+This component displays the app logo, event logo, and event information
+in a clean, accessible layout suitable for public pages.
+
+#### Parameters
+
+| Name | Type | Description |
+| :------ | :------ | :------ |
+| `props` | [`PublicPageHeaderProps`](interfaces/PublicPageHeaderProps.md) | Header configuration and content |
+
+#### 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 |
+
+#### Returns
+
+`Element`
+
+React element with complete public page layout
+
+#### 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)
+
+___
+
+### usePublicPageContext
+
+▸ **usePublicPageContext**(): `Object`
+
+Hook for accessing public page context
+Provides access to event data and layout state within public pages
+
+ This hook is no longer needed as PublicPageLayout no longer
+automatically fetches event data. Use usePublicRouteParams and usePublicEvent
+directly in your components instead.
+
+#### Returns
+
+`Object`
+
+| Name | Type |
+| :------ | :------ |
+| `eventCode` | ``null`` |
+| `eventId` | ``null`` |
+| `event` | ``null`` |
+| `isLoading` | `boolean` |
+| `error` | ``null`` |
+| `refetch` | () => `Promise`\<`void`\> |
+| `isPublicPage` | `boolean` |
+
+#### 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)
+
+___
+
+### PublicPageProvider
+
+▸ **PublicPageProvider**(`«destructured»`): `Element`
+
+Provider for public pages that completely isolates them from authentication context
+
+This provider:
+- Does not initialize any authentication providers
+- Provides environment variables for public data access
+- Includes error boundary for graceful error handling
+- Is completely separate from the main app context
+
+#### Parameters
+
+| Name | Type |
+| :------ | :------ |
+| `«destructured»` | `PublicPageProviderProps` |
+
+#### Returns
+
+`Element`
+
+#### 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)
+
+___
+
+### usePublicPageProviderContext
+
+▸ **usePublicPageProviderContext**(): `PublicPageContextType`
+
+Hook to access public page context
+
+#### Returns
+
+`PublicPageContextType`
+
+Public page context with environment variables
+
+#### Defined in
+
+[packages/core/src/components/PublicLayout/PublicPageProvider.tsx:119](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/PublicLayout/PublicPageProvider.tsx#L119)
+
+___
+
+### useIsPublicPage
+
+▸ **useIsPublicPage**(): `boolean`
+
+Hook to check if we're in a public page context
+
+#### Returns
+
+`boolean`
+
+True if we're in a public page context
+
+#### 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)
+
+___
+
+### Select
+
+▸ **Select**(`props`): `ReactNode`
+
+#### Parameters
+
+| Name | Type |
+| :------ | :------ |
+| `props` | `SelectProps` & `RefAttributes`\<`HTMLFormElement`\> |
+
+#### Returns
+
+`ReactNode`
+
+#### 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)
+
+___
+
+### SelectTrigger
+
+▸ **SelectTrigger**(`props`): `ReactNode`
+
+#### Parameters
+
+| Name | Type |
+| :------ | :------ |
+| `props` | `SelectTriggerProps` & `RefAttributes`\<`HTMLButtonElement`\> |
+
+#### Returns
+
+`ReactNode`
+
+#### Defined in
+
+[packages/core/src/components/Select/Select.tsx:269](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Select/Select.tsx#L269)
+
+___
+
+### SelectValue
+
+▸ **SelectValue**(`props`): `ReactNode`
+
+#### Parameters
+
+| Name | Type |
+| :------ | :------ |
+| `props` | `SelectValueProps` & `RefAttributes`\<`HTMLSpanElement`\> |
+
+#### Returns
+
+`ReactNode`
+
+#### Defined in
+
+[packages/core/src/components/Select/Select.tsx:392](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Select/Select.tsx#L392)
+
+___
+
+### SelectContent
+
+▸ **SelectContent**(`props`): `ReactNode`
+
+#### Parameters
+
+| Name | Type |
+| :------ | :------ |
+| `props` | `SelectContentProps` & `RefAttributes`\<`HTMLUListElement`\> |
+
+#### Returns
+
+`ReactNode`
+
+#### Defined in
+
+[packages/core/src/components/Select/Select.tsx:409](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Select/Select.tsx#L409)
+
+___
+
+### SelectItem
+
+▸ **SelectItem**(`props`): `ReactNode`
+
+#### Parameters
+
+| Name | Type |
+| :------ | :------ |
+| `props` | `SelectItemProps` & `RefAttributes`\<`HTMLLIElement`\> |
+
+#### Returns
+
+`ReactNode`
+
+#### Defined in
+
+[packages/core/src/components/Select/Select.tsx:536](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Select/Select.tsx#L536)
+
+___
+
+### SelectGroup
+
+▸ **SelectGroup**(`props`): `ReactNode`
+
+#### Parameters
+
+| Name | Type |
+| :------ | :------ |
+| `props` | \{ `children`: `ReactNode` ; `className?`: `string`  } & `RefAttributes`\<`HTMLDivElement`\> |
+
+#### Returns
+
+`ReactNode`
+
+#### Defined in
+
+[packages/core/src/components/Select/Select.tsx:621](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Select/Select.tsx#L621)
+
+___
+
+### SelectLabel
+
+▸ **SelectLabel**(`props`): `ReactNode`
+
+#### Parameters
+
+| Name | Type |
+| :------ | :------ |
+| `props` | \{ `children`: `ReactNode` ; `className?`: `string`  } & `RefAttributes`\<`HTMLDivElement`\> |
+
+#### Returns
+
+`ReactNode`
+
+#### Defined in
+
+[packages/core/src/components/Select/Select.tsx:632](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Select/Select.tsx#L632)
+
+___
+
+### SelectSeparator
+
+▸ **SelectSeparator**(`props`): `ReactNode`
+
+#### Parameters
+
+| Name | Type |
+| :------ | :------ |
+| `props` | \{ `className?`: `string`  } & `RefAttributes`\<`HTMLDivElement`\> |
+
+#### Returns
+
+`ReactNode`
+
+#### Defined in
+
+[packages/core/src/components/Select/Select.tsx:643](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Select/Select.tsx#L643)
+
+___
+
+### Table
+
+▸ **Table**(`props`): `ReactNode`
+
+Table component
+The main table container with semantic HTML structure
+
+#### Parameters
+
+| Name | Type | Description |
+| :------ | :------ | :------ |
+| `props` | `HTMLAttributes`\<`HTMLTableElement`\> & `RefAttributes`\<`HTMLTableElement`\> | Table configuration and styling |
+
+#### Returns
+
+`ReactNode`
+
+JSX.Element - The rendered table element
+
+**`Example`**
+
+```tsx
+<Table>
+  <TableHeader>...</TableHeader>
+  <TableBody>...</TableBody>
+</Table>
+```
+
+#### Defined in
+
+[packages/core/src/components/Table/Table.tsx:112](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Table/Table.tsx#L112)
+
+___
+
+### TableHeader
+
+▸ **TableHeader**(`props`): `ReactNode`
+
+#### Parameters
+
+| Name | Type |
+| :------ | :------ |
+| `props` | `HTMLAttributes`\<`HTMLTableSectionElement`\> & `RefAttributes`\<`HTMLTableSectionElement`\> |
+
+#### Returns
+
+`ReactNode`
+
+#### Defined in
+
+[packages/core/src/components/Table/Table.tsx:124](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Table/Table.tsx#L124)
+
+___
+
+### TableBody
+
+▸ **TableBody**(`props`): `ReactNode`
+
+#### Parameters
+
+| Name | Type |
+| :------ | :------ |
+| `props` | `HTMLAttributes`\<`HTMLTableSectionElement`\> & `RefAttributes`\<`HTMLTableSectionElement`\> |
+
+#### Returns
+
+`ReactNode`
+
+#### Defined in
+
+[packages/core/src/components/Table/Table.tsx:132](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Table/Table.tsx#L132)
+
+___
+
+### TableFooter
+
+▸ **TableFooter**(`props`): `ReactNode`
+
+#### Parameters
+
+| Name | Type |
+| :------ | :------ |
+| `props` | `HTMLAttributes`\<`HTMLTableSectionElement`\> & `RefAttributes`\<`HTMLTableSectionElement`\> |
+
+#### Returns
+
+`ReactNode`
+
+#### Defined in
+
+[packages/core/src/components/Table/Table.tsx:144](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Table/Table.tsx#L144)
+
+___
+
+### TableRow
+
+▸ **TableRow**(`props`): `ReactNode`
+
+#### Parameters
+
+| Name | Type |
+| :------ | :------ |
+| `props` | `HTMLAttributes`\<`HTMLTableRowElement`\> & `RefAttributes`\<`HTMLTableRowElement`\> |
+
+#### Returns
+
+`ReactNode`
+
+#### Defined in
+
+[packages/core/src/components/Table/Table.tsx:159](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Table/Table.tsx#L159)
+
+___
+
+### TableHead
+
+▸ **TableHead**(`props`): `ReactNode`
+
+#### Parameters
+
+| Name | Type |
+| :------ | :------ |
+| `props` | `ThHTMLAttributes`\<`HTMLTableCellElement`\> & `RefAttributes`\<`HTMLTableCellElement`\> |
+
+#### Returns
+
+`ReactNode`
+
+#### Defined in
+
+[packages/core/src/components/Table/Table.tsx:174](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Table/Table.tsx#L174)
+
+___
+
+### TableCell
+
+▸ **TableCell**(`props`): `ReactNode`
+
+#### Parameters
+
+| Name | Type |
+| :------ | :------ |
+| `props` | `TdHTMLAttributes`\<`HTMLTableCellElement`\> & `RefAttributes`\<`HTMLTableCellElement`\> |
+
+#### Returns
+
+`ReactNode`
+
+#### Defined in
+
+[packages/core/src/components/Table/Table.tsx:189](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Table/Table.tsx#L189)
+
+___
+
+### TableCaption
+
+▸ **TableCaption**(`props`): `ReactNode`
+
+#### Parameters
+
+| Name | Type |
+| :------ | :------ |
+| `props` | `HTMLAttributes`\<`HTMLTableCaptionElement`\> & `RefAttributes`\<`HTMLTableCaptionElement`\> |
+
+#### Returns
+
+`ReactNode`
+
+#### Defined in
+
+[packages/core/src/components/Table/Table.tsx:201](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Table/Table.tsx#L201)
+
+___
+
+### ToastProvider
+
+▸ **ToastProvider**(`props`, `deprecatedLegacyContext?`): `ReactNode`
+
+#### Parameters
+
+| Name | Type | Description |
+| :------ | :------ | :------ |
+| `props` | `ToastProviderProps` | - |
+| `deprecatedLegacyContext?` | `any` | **`See`** [React Docs](https://legacy.reactjs.org/docs/legacy-context.html#referencing-context-in-lifecycle-methods) |
+
+#### Returns
+
+`ReactNode`
+
+#### Defined in
+
+[packages/core/src/components/Toast/Toast.tsx:93](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Toast/Toast.tsx#L93)
+
+___
+
+### ToastViewport
+
+▸ **ToastViewport**(`props`): `ReactNode`
+
+ToastViewport component
+Container for all toast notifications with customizable positioning
+
+#### Parameters
+
+| Name | Type | Description |
+| :------ | :------ | :------ |
+| `props` | `Omit`\<`ToastViewportProps` & `RefAttributes`\<`HTMLOListElement`\>, ``"ref"``\> & `RefAttributes`\<`HTMLOListElement`\> | Viewport configuration and styling |
+
+#### Returns
+
+`ReactNode`
+
+JSX.Element - The toast viewport container
+
+#### Defined in
+
+[packages/core/src/components/Toast/Toast.tsx:103](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Toast/Toast.tsx#L103)
+
+___
+
+### Toast
+
+▸ **Toast**(`props`): `ReactNode`
+
+Toast component
+The main toast notification component with animations and interactions
+
+#### Parameters
+
+| Name | Type | Description |
+| :------ | :------ | :------ |
+| `props` | `Omit`\<`ToastProps` & `RefAttributes`\<`HTMLLIElement`\>, ``"ref"``\> & `RefAttributes`\<`HTMLLIElement`\> | Toast configuration and content |
+
+#### Returns
+
+`ReactNode`
+
+JSX.Element - The rendered toast notification
+
+**`Example`**
+
+```tsx
+<Toast>
+  <ToastTitle>Success!</ToastTitle>
+  <ToastDescription>Your changes have been saved.</ToastDescription>
+  <ToastClose />
+</Toast>
+```
+
+#### Defined in
+
+[packages/core/src/components/Toast/Toast.tsx:136](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Toast/Toast.tsx#L136)
+
+___
+
+### ToastAction
+
+▸ **ToastAction**(`props`): `ReactNode`
+
+ToastAction component
+Action button within a toast notification
+
+#### Parameters
+
+| Name | Type | Description |
+| :------ | :------ | :------ |
+| `props` | `Omit`\<`ToastActionProps` & `RefAttributes`\<`HTMLButtonElement`\>, ``"ref"``\> & `RefAttributes`\<`HTMLButtonElement`\> | Action button configuration |
+
+#### Returns
+
+`ReactNode`
+
+JSX.Element - The action button element
+
+**`Example`**
+
+```tsx
+<ToastAction altText="Undo changes">Undo</ToastAction>
+```
+
+#### Defined in
+
+[packages/core/src/components/Toast/Toast.tsx:167](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Toast/Toast.tsx#L167)
+
+___
+
+### ToastClose
+
+▸ **ToastClose**(`props`): `ReactNode`
+
+ToastClose component
+Close button for dismissing toast notifications
+
+#### Parameters
+
+| Name | Type | Description |
+| :------ | :------ | :------ |
+| `props` | `Omit`\<`ToastCloseProps` & `RefAttributes`\<`HTMLButtonElement`\>, ``"ref"``\> & `RefAttributes`\<`HTMLButtonElement`\> | Close button configuration |
+
+#### Returns
+
+`ReactNode`
+
+JSX.Element - The close button with X icon
+
+**`Example`**
+
+```tsx
+<ToastClose />
+```
+
+#### Defined in
+
+[packages/core/src/components/Toast/Toast.tsx:196](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Toast/Toast.tsx#L196)
+
+___
+
+### ToastTitle
+
+▸ **ToastTitle**(`props`): `ReactNode`
+
+ToastTitle component
+Title text for toast notifications
+
+#### Parameters
+
+| Name | Type | Description |
+| :------ | :------ | :------ |
+| `props` | `Omit`\<`ToastTitleProps` & `RefAttributes`\<`HTMLDivElement`\>, ``"ref"``\> & `RefAttributes`\<`HTMLDivElement`\> | Title configuration and styling |
+
+#### Returns
+
+`ReactNode`
+
+JSX.Element - The toast title
+
+**`Example`**
+
+```tsx
+<ToastTitle>Success!</ToastTitle>
+```
+
+#### Defined in
+
+[packages/core/src/components/Toast/Toast.tsx:228](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Toast/Toast.tsx#L228)
+
+___
+
+### ToastDescription
+
+▸ **ToastDescription**(`props`): `ReactNode`
+
+ToastDescription component
+Description text for toast notifications
+
+#### Parameters
+
+| Name | Type | Description |
+| :------ | :------ | :------ |
+| `props` | `Omit`\<`ToastDescriptionProps` & `RefAttributes`\<`HTMLDivElement`\>, ``"ref"``\> & `RefAttributes`\<`HTMLDivElement`\> | Description configuration and styling |
+
+#### Returns
+
+`ReactNode`
+
+JSX.Element - The toast description
+
+**`Example`**
+
+```tsx
+<ToastDescription>Your changes have been saved successfully.</ToastDescription>
+```
+
+#### Defined in
+
+[packages/core/src/components/Toast/Toast.tsx:254](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Toast/Toast.tsx#L254)
+
+___
+
+### useToast
+
+▸ **useToast**(): `Object`
+
+useToast hook
+Hook for managing toast notifications
+
+#### Returns
+
+`Object`
+
+Object with toast and dismiss functions
+
+| Name | Type |
+| :------ | :------ |
+| `toast` | (`props`: `any`) => `void` |
+| `dismiss` | () => `void` |
+
+**`Example`**
+
+```tsx
+const { toast, dismiss } = useToast();
+
+// Show a toast
+toast({
+  title: "Success!",
+  description: "Your changes have been saved."
+});
+
+// Dismiss all toasts
+dismiss();
+```
+
+#### Defined in
+
+[packages/core/src/components/Toast/Toast.tsx:292](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Toast/Toast.tsx#L292)
+
+___
+
+### Toaster
+
+▸ **Toaster**(): `Element`
+
+Toaster component
+Container component that provides the toast viewport
+Should be placed at the root of your application
+
+#### Returns
+
+`Element`
+
+JSX.Element - The toast provider with viewport
+
+**`Example`**
+
+```tsx
+function App() {
+  return (
+    <ToastProvider>
+      <YourApp />
+      <Toaster />
+    </ToastProvider>
+  );
+}
+```
+
+#### Defined in
+
+[packages/core/src/components/Toast/Toast.tsx:323](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Toast/Toast.tsx#L323)
+
+___
+
+### TooltipProvider
+
+▸ **TooltipProvider**(`props`, `deprecatedLegacyContext?`): `ReactNode`
+
+#### Parameters
+
+| Name | Type | Description |
+| :------ | :------ | :------ |
+| `props` | `TooltipProviderProps` | - |
+| `deprecatedLegacyContext?` | `any` | **`See`** [React Docs](https://legacy.reactjs.org/docs/legacy-context.html#referencing-context-in-lifecycle-methods) |
+
+#### Returns
+
+`ReactNode`
+
+#### Defined in
+
+[packages/core/src/components/Tooltip/Tooltip.tsx:78](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Tooltip/Tooltip.tsx#L78)
+
+___
+
+### TooltipRoot
+
+▸ **TooltipRoot**(`props`, `deprecatedLegacyContext?`): `ReactNode`
+
+#### Parameters
+
+| Name | Type | Description |
+| :------ | :------ | :------ |
+| `props` | `TooltipProps` | - |
+| `deprecatedLegacyContext?` | `any` | **`See`** [React Docs](https://legacy.reactjs.org/docs/legacy-context.html#referencing-context-in-lifecycle-methods) |
+
+#### Returns
+
+`ReactNode`
+
+#### Defined in
+
+[packages/core/src/components/Tooltip/Tooltip.tsx:80](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Tooltip/Tooltip.tsx#L80)
+
+___
+
+### TooltipTrigger
+
+▸ **TooltipTrigger**(`props`): `ReactNode`
+
+#### Parameters
+
+| Name | Type |
+| :------ | :------ |
+| `props` | `TooltipTriggerProps` & `RefAttributes`\<`HTMLButtonElement`\> |
+
+#### Returns
+
+`ReactNode`
+
+#### Defined in
+
+[packages/core/src/components/Tooltip/Tooltip.tsx:82](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Tooltip/Tooltip.tsx#L82)
+
+___
+
+### TooltipContent
+
+▸ **TooltipContent**(`props`): `ReactNode`
+
+TooltipContent component
+The content container for tooltip information
+
+#### Parameters
+
+| Name | Type | Description |
+| :------ | :------ | :------ |
+| `props` | `Omit`\<`TooltipContentProps` & `RefAttributes`\<`HTMLDivElement`\>, ``"ref"``\> & `RefAttributes`\<`HTMLDivElement`\> | Content configuration and styling |
+
+#### Returns
+
+`ReactNode`
+
+JSX.Element - The tooltip content container
+
+**`Example`**
+
+```tsx
+<TooltipContent side="top" className="bg-main-500">
+  Custom tooltip content
+</TooltipContent>
+```
+
+#### Defined in
+
+[packages/core/src/components/Tooltip/Tooltip.tsx:99](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Tooltip/Tooltip.tsx#L99)
+
+___
+
+### Tooltip
+
+▸ **Tooltip**(`props`): `ReactNode`
+
+Tooltip component
+A simplified tooltip component for easy usage
+
+#### Parameters
+
+| Name | Type | Description |
+| :------ | :------ | :------ |
+| `props` | `TooltipProps` & `RefAttributes`\<`HTMLButtonElement`\> | Tooltip configuration |
+
+#### Returns
+
+`ReactNode`
+
+JSX.Element - The tooltip with trigger and content
+
+**`Example`**
+
+```tsx
+<Tooltip content="This is a helpful tooltip">
+  <Button>Hover me</Button>
+</Tooltip>
+```
+
+#### Defined in
+
+[packages/core/src/components/Tooltip/Tooltip.tsx:142](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Tooltip/Tooltip.tsx#L142)
+
+___
+
+### 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``
+
+Utility function to extract event code from a public route path
+
+#### Parameters
+
+| Name | Type |
+| :------ | :------ |
+| `path` | `string` |
+
+#### Returns
+
+`string` \| ``null``
+
+#### 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)
+
+___
+
+### useAppConfig
+
+▸ **useAppConfig**(): `UseAppConfigReturn`
+
+Hook to access app configuration
+Works in both authenticated and public contexts
+
+#### Returns
+
+`UseAppConfigReturn`
+
+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)
+
+___
+
+### useOrganisationPermissions
+
+▸ **useOrganisationPermissions**(`orgId?`): `UseOrganisationPermissionsReturn`
+
+Hook to access organisation-specific permissions and roles
+
+#### Parameters
+
+| Name | Type | Description |
+| :------ | :------ | :------ |
+| `orgId?` | `string` | Optional organisation ID. Defaults to currently selected organisation |
+
+#### Returns
+
+`UseOrganisationPermissionsReturn`
+
+Organisation permissions and role information
+
+#### Defined in
+
+[packages/core/src/hooks/useOrganisationPermissions.ts:96](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/hooks/useOrganisationPermissions.ts#L96)
+
+___
+
+### useOrganisationSecurity
+
+▸ **useOrganisationSecurity**(): `OrganisationSecurityHook`
+
+#### Returns
+
+`OrganisationSecurityHook`
+
+#### Defined in
+
+[packages/core/src/hooks/useOrganisationSecurity.ts:39](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/hooks/useOrganisationSecurity.ts#L39)
+
+___
+
+### 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)
+
+#### Returns
+
+[`EventContextType`](interfaces/EventContextType.md)
+
+#### Defined in
+
+[packages/core/src/providers/EventProvider.tsx:29](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/providers/EventProvider.tsx#L29)
+
+___
+
+### EventProvider
+
+▸ **EventProvider**(`«destructured»`): `Element`
+
+#### Parameters
+
+| Name | Type |
+| :------ | :------ |
+| `«destructured»` | [`EventProviderProps`](interfaces/EventProviderProps.md) |
+
+#### Returns
+
+`Element`
+
+#### Defined in
+
+[packages/core/src/providers/EventProvider.tsx:68](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/providers/EventProvider.tsx#L68)
+
+___
+
+### OrganisationProvider
+
+▸ **OrganisationProvider**(`«destructured»`): `Element`
+
+Organisation Provider component that enforces mandatory organisation context
+
+This provider:
+- Loads user's organisation memberships on authentication
+- Validates user has at least one active organisation
+- Auto-selects primary organisation or first available
+- Provides security helpers for organisation validation
+- Handles organisation switching with validation
+- Persists organisation selection across sessions
+
+SECURITY: No children are rendered without valid organisation context
+
+#### Parameters
+
+| Name | Type |
+| :------ | :------ |
+| `«destructured»` | [`OrganisationProviderProps`](interfaces/OrganisationProviderProps.md) |
+
+#### Returns
+
+`Element`
+
+#### Defined in
+
+[packages/core/src/providers/OrganisationProvider.tsx:103](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/providers/OrganisationProvider.tsx#L103)
+
+___
+
+### useOrganisations
+
+▸ **useOrganisations**(): [`OrganisationContextType`](interfaces/OrganisationContextType.md)
+
+Hook to access organisation context
+
+#### Returns
+
+[`OrganisationContextType`](interfaces/OrganisationContextType.md)
+
+Organisation context with guaranteed non-null selectedOrganisation
+
+**`Throws`**
+
+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)
+
+___
+
+### useUnifiedAuth
+
+▸ **useUnifiedAuth**(): [`UnifiedAuthContextType`](interfaces/UnifiedAuthContextType.md)
+
+#### Returns
+
+[`UnifiedAuthContextType`](interfaces/UnifiedAuthContextType.md)
+
+#### Defined in
+
+[packages/core/src/providers/UnifiedAuthProvider.tsx:177](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/providers/UnifiedAuthProvider.tsx#L177)
+
+___
+
+### UnifiedAuthProvider
+
+▸ **UnifiedAuthProvider**(`«destructured»`): `Element`
+
+#### Parameters
+
+| Name | Type |
+| :------ | :------ |
+| `«destructured»` | [`UnifiedAuthProviderProps`](interfaces/UnifiedAuthProviderProps.md) |
+
+#### Returns
+
+`Element`
+
+#### Defined in
+
+[packages/core/src/providers/UnifiedAuthProvider.tsx:294](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/providers/UnifiedAuthProvider.tsx#L294)
+
+___
+
+### getStylePath
+
+▸ **getStylePath**(`style`): `string`
+
+#### Parameters
+
+| Name | Type |
+| :------ | :------ |
+| `style` | ``"core"`` |
+
+#### Returns
+
+`string`
+
+#### Defined in
+
+[packages/core/src/styles/index.ts:40](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/styles/index.ts#L40)
+
+___
+
+### getAllStylePaths
+
+▸ **getAllStylePaths**(): `string`[]
+
+#### Returns
+
+`string`[]
+
+#### Defined in
+
+[packages/core/src/styles/index.ts:45](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/styles/index.ts#L45)
+
+___
+
+### applyPalette
+
+▸ **applyPalette**(`palette`): `void`
+
+Applies a complete palette to the document by replacing all three palette variable sets.
+Writes a single <style id="pace-theme-dynamic"> block into <head>.
+
+#### Parameters
+
+| Name | Type | Description |
+| :------ | :------ | :------ |
+| `palette` | [`PaletteData`](interfaces/PaletteData.md) | Complete palette data with main, sec, and acc palettes |
+
+#### Returns
+
+`void`
+
+#### Defined in
+
+[packages/core/src/theming/runtime.ts:64](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/theming/runtime.ts#L64)
+
+___
+
+### clearPalette
+
+▸ **clearPalette**(): `void`
+
+Removes the dynamic theme block, returning to app-defined CSS values.
+
+#### Returns
+
+`void`
+
+#### Defined in
+
+[packages/core/src/theming/runtime.ts:86](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/theming/runtime.ts#L86)
+
+___
+
+### generateSSRThemeCSS
+
+▸ **generateSSRThemeCSS**(`palette`): `string`
+
+Generates the same CSS block for SSR rendering
+Use this in your SSR setup to avoid FOUC
+
+#### Parameters
+
+| Name | Type |
+| :------ | :------ |
+| `palette` | [`PaletteData`](interfaces/PaletteData.md) |
+
+#### Returns
+
+`string`
+
+#### Defined in
+
+[packages/core/src/theming/runtime.ts:154](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/theming/runtime.ts#L154)
+
+___
+
+### isDynamicThemingActive
+
+▸ **isDynamicThemingActive**(): `boolean`
+
+Checks if dynamic theming is currently active
+
+#### Returns
+
+`boolean`
+
+#### Defined in
+
+[packages/core/src/theming/runtime.ts:161](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/theming/runtime.ts#L161)
+
+___
+
+### getCurrentThemeData
+
+▸ **getCurrentThemeData**(): [`PaletteData`](interfaces/PaletteData.md) \| ``null``
+
+Gets the current dynamic theme data (if any)
+Useful for debugging or persistence
+
+#### Returns
+
+[`PaletteData`](interfaces/PaletteData.md) \| ``null``
+
+#### Defined in
+
+[packages/core/src/theming/runtime.ts:173](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/theming/runtime.ts#L173)
+
+___
+
+### setAppConfig
+
+▸ **setAppConfig**(`config`): `void`
+
+Set the current application configuration
+
+#### Parameters
+
+| Name | Type |
+| :------ | :------ |
+| `config` | `AppConfig` |
+
+#### Returns
+
+`void`
+
+#### Defined in
+
+[packages/core/src/utils/appConfig.ts:16](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/utils/appConfig.ts#L16)
+
+___
+
+### getAppConfig
+
+▸ **getAppConfig**(): `AppConfig`
+
+Get the current application configuration
+
+#### Returns
+
+`AppConfig`
+
+#### Defined in
+
+[packages/core/src/utils/appConfig.ts:23](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/utils/appConfig.ts#L23)
+
+___
+
+### getCurrentAppName
+
+▸ **getCurrentAppName**(): `string`
+
+Get the current app name
+
+#### Returns
+
+`string`
+
+#### Defined in
+
+[packages/core/src/utils/appConfig.ts:38](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/utils/appConfig.ts#L38)
+
+___
+
+### getCurrentAppId
+
+▸ **getCurrentAppId**(): `string`
+
+Get the current app ID
+
+#### Returns
+
+`string`
+
+#### Defined in
+
+[packages/core/src/utils/appConfig.ts:45](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/utils/appConfig.ts#L45)
+
+___
+
+### cn
+
+▸ **cn**(`...inputs`): `string`
+
+#### Parameters
+
+| Name | Type |
+| :------ | :------ |
+| `...inputs` | `ClassValue`[] |
+
+#### Returns
+
+`string`
+
+#### Defined in
+
+[packages/core/src/utils/cn.ts:5](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/utils/cn.ts#L5)
+
+___
+
+### createSecureDataAccess
+
+▸ **createSecureDataAccess**(`supabase`, `organisationId`, `isSuperAdmin?`): `SecureDataAccess`
+
+Create a secure data access instance
+
+#### Parameters
+
+| Name | Type | Default value | Description |
+| :------ | :------ | :------ | :------ |
+| `supabase` | `default`\<`any`, ``"public"``, ``"public"``, `any`, `any`\> | `undefined` | Supabase client instance |
+| `organisationId` | `string` | `undefined` | Current organisation context |
+| `isSuperAdmin` | `boolean` | `false` | Whether user has super admin privileges |
+
+#### Returns
+
+`SecureDataAccess`
+
+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)