npm - @jmruthers/pace-core - Versions diffs - 0.5.135 → 0.5.136 - Mend

@jmruthers/pace-core 0.5.135 → 0.5.136

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (522) hide show

package/docs/api/modules.md CHANGED Viewed

@@ -1,6 +1,6 @@
-[@jmruthers/pace-core - v0.5.135](README.md) / Exports
+[@jmruthers/pace-core - v0.5.136](README.md) / Exports
-# @jmruthers/pace-core - v0.5.135
+# @jmruthers/pace-core - v0.5.136
 **`File`**
@@ -75,12 +75,14 @@ import { Dialog, NavigationMenu } from '@jmruthers/pace-core/components';
 - [PaceAppLayoutProps](interfaces/PaceAppLayoutProps.md)
 - [PaceLoginPageProps](interfaces/PaceLoginPageProps.md)
 - [ProtectedRouteProps](interfaces/ProtectedRouteProps.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)
+- [SessionRestorationLoaderProps](interfaces/SessionRestorationLoaderProps.md)
 - [SwitchProps](interfaces/SwitchProps.md)
 - [ToastProps](interfaces/ToastProps.md)
 - [ToastActionElement](interfaces/ToastActionElement.md)
@@ -195,6 +197,11 @@ import { Dialog, NavigationMenu } from '@jmruthers/pace-core/components';
 - [CardActions](modules.md#cardactions)
 - [Checkbox](modules.md#checkbox)
 - [DataTable](modules.md#datatable)
+- [sum](modules.md#sum)
+- [average](modules.md#average)
+- [count](modules.md#count)
+- [min](modules.md#min)
+- [max](modules.md#max)
 - [generateCSVContent](modules.md#generatecsvcontent)
 - [exportToCSVWithTableRows](modules.md#exporttocsvwithtablerows)
 - [exportToCSV](modules.md#exporttocsv)
@@ -225,17 +232,17 @@ import { Dialog, NavigationMenu } from '@jmruthers/pace-core/components';
 - [PaceAppLayout](modules.md#paceapplayout)
 - [PaceLoginPage](modules.md#paceloginpage)
 - [PasswordChangeForm](modules.md#passwordchangeform)
-- [PasswordResetForm](modules.md#passwordresetform)
 - [Progress](modules.md#progress)
 - [ProtectedRoute](modules.md#protectedroute)
+- [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)
@@ -374,6 +381,7 @@ import { Dialog, NavigationMenu } from '@jmruthers/pace-core/components';
 - [getAppConfig](modules.md#getappconfig)
 - [getCurrentAppName](modules.md#getcurrentappname)
 - [getCurrentAppId](modules.md#getcurrentappid)
+- [useSessionTracking](modules.md#usesessiontracking)
 - [cn](modules.md#cn)
 - [formatDate](modules.md#formatdate)
 - [formatCurrency](modules.md#formatcurrency)
@@ -382,7 +390,6 @@ import { Dialog, NavigationMenu } from '@jmruthers/pace-core/components';
 - [formatCompactNumber](modules.md#formatcompactnumber)
 - [formatFileSize](modules.md#formatfilesize)
 - [createSecureDataAccess](modules.md#createsecuredataaccess)
-- [useSessionTracking](modules.md#usesessiontracking)
 - [getFileSizeLimit](modules.md#getfilesizelimit)
 - [getBucketName](modules.md#getbucketname)
 - [validateFileSize](modules.md#validatefilesize)
@@ -446,7 +453,7 @@ ___
 #### Defined in
-[packages/core/src/hooks/useFileReference.ts:448](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/hooks/useFileReference.ts#L448)
+[packages/core/src/hooks/useFileReference.ts:451](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/hooks/useFileReference.ts#L451)
 ___
@@ -472,7 +479,7 @@ ___
 #### Defined in
-[packages/core/src/hooks/useFileReference.ts:454](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/hooks/useFileReference.ts#L454)
+[packages/core/src/hooks/useFileReference.ts:457](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/hooks/useFileReference.ts#L457)
 ___
@@ -500,7 +507,7 @@ ___
 #### Defined in
-[packages/core/src/hooks/useFileReference.ts:468](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/hooks/useFileReference.ts#L468)
+[packages/core/src/hooks/useFileReference.ts:471](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/hooks/useFileReference.ts#L471)
 ___
@@ -520,7 +527,7 @@ ___
 #### Defined in
-[packages/core/src/rbac/permissions.ts:208](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/permissions.ts#L208)
+[packages/core/src/rbac/permissions.ts:211](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/permissions.ts#L211)
 ___
@@ -693,7 +700,7 @@ ___
 #### Defined in
-[packages/core/src/rbac/permissions.ts:17](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/permissions.ts#L17)
+[packages/core/src/rbac/permissions.ts:20](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/permissions.ts#L20)
 ___
@@ -727,7 +734,7 @@ ___
 #### Defined in
-[packages/core/src/rbac/permissions.ts:28](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/permissions.ts#L28)
+[packages/core/src/rbac/permissions.ts:31](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/permissions.ts#L31)
 ___
@@ -766,7 +773,7 @@ ___
 #### Defined in
-[packages/core/src/rbac/permissions.ts:63](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/permissions.ts#L63)
+[packages/core/src/rbac/permissions.ts:66](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/permissions.ts#L66)
 ___
@@ -801,7 +808,7 @@ ___
 #### Defined in
-[packages/core/src/rbac/permissions.ts:105](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/permissions.ts#L105)
+[packages/core/src/rbac/permissions.ts:108](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/permissions.ts#L108)
 ___
@@ -883,7 +890,7 @@ ___
 #### Defined in
-[packages/core/src/rbac/permissions.ts:201](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/permissions.ts#L201)
+[packages/core/src/rbac/permissions.ts:204](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/permissions.ts#L204)
 ___
@@ -1310,6 +1317,296 @@ Features are configured through the unified `features` prop for maximum flexibil
 ___
+### sum
+▸ **sum**\<`TData`\>(`accessorKey`): \<TRow\>(`rows`: `TRow`[], `column`: [`DataTableColumn`](interfaces/DataTableColumn.md)\<`TRow`\>) => `number`
+Creates a sum aggregation function for a specific field.
+#### Type parameters
+| Name | Type |
+| :------ | :------ |
+| `TData` | extends [`DataRecord`](interfaces/DataRecord.md) = [`DataRecord`](interfaces/DataRecord.md) |
+#### Parameters
+| Name | Type | Description |
+| :------ | :------ | :------ |
+| `accessorKey` | `string` \| keyof `TData` | The field key to sum (e.g., 'cost', 'quantity') |
+#### Returns
+`fn`
+An aggregation function that sums the specified field across all rows
+▸ \<`TRow`\>(`rows`, `column`): `number`
+##### Type parameters
+| Name | Type |
+| :------ | :------ |
+| `TRow` | extends [`DataRecord`](interfaces/DataRecord.md) = `TData` |
+##### Parameters
+| Name | Type |
+| :------ | :------ |
+| `rows` | `TRow`[] |
+| `column` | [`DataTableColumn`](interfaces/DataTableColumn.md)\<`TRow`\> |
+##### Returns
+`number`
+**`Example`**
+```tsx
+{
+  accessorKey: 'cost',
+  header: 'Total Cost',
+  aggregateFn: sum('cost'),
+}
+```
+#### Defined in
+[packages/core/src/components/DataTable/utils/aggregationUtils.ts:28](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/DataTable/utils/aggregationUtils.ts#L28)
+___
+### average
+▸ **average**\<`TData`\>(`accessorKey`): \<TRow\>(`rows`: `TRow`[], `column`: [`DataTableColumn`](interfaces/DataTableColumn.md)\<`TRow`\>) => `number`
+Creates an average aggregation function for a specific field.
+#### Type parameters
+| Name | Type |
+| :------ | :------ |
+| `TData` | extends [`DataRecord`](interfaces/DataRecord.md) = [`DataRecord`](interfaces/DataRecord.md) |
+#### Parameters
+| Name | Type | Description |
+| :------ | :------ | :------ |
+| `accessorKey` | `string` \| keyof `TData` | The field key to average (e.g., 'price', 'rating') |
+#### Returns
+`fn`
+An aggregation function that calculates the average of the specified field across all rows
+▸ \<`TRow`\>(`rows`, `column`): `number`
+##### Type parameters
+| Name | Type |
+| :------ | :------ |
+| `TRow` | extends [`DataRecord`](interfaces/DataRecord.md) = `TData` |
+##### Parameters
+| Name | Type |
+| :------ | :------ |
+| `rows` | `TRow`[] |
+| `column` | [`DataTableColumn`](interfaces/DataTableColumn.md)\<`TRow`\> |
+##### Returns
+`number`
+**`Example`**
+```tsx
+{
+  accessorKey: 'price',
+  header: 'Avg Price',
+  aggregateFn: average('price'),
+}
+```
+#### Defined in
+[packages/core/src/components/DataTable/utils/aggregationUtils.ts:53](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/DataTable/utils/aggregationUtils.ts#L53)
+___
+### count
+▸ **count**\<`TData`\>(): \<TRow\>(`rows`: `TRow`[], `column`: [`DataTableColumn`](interfaces/DataTableColumn.md)\<`TRow`\>) => `number`
+Creates a count aggregation function.
+Returns the number of rows in the group.
+#### Type parameters
+| Name | Type |
+| :------ | :------ |
+| `TData` | extends [`DataRecord`](interfaces/DataRecord.md) = [`DataRecord`](interfaces/DataRecord.md) |
+#### Returns
+`fn`
+An aggregation function that counts the number of rows
+▸ \<`TRow`\>(`rows`, `column`): `number`
+##### Type parameters
+| Name | Type |
+| :------ | :------ |
+| `TRow` | extends [`DataRecord`](interfaces/DataRecord.md) = `TData` |
+##### Parameters
+| Name | Type |
+| :------ | :------ |
+| `rows` | `TRow`[] |
+| `column` | [`DataTableColumn`](interfaces/DataTableColumn.md)\<`TRow`\> |
+##### Returns
+`number`
+**`Example`**
+```tsx
+{
+  accessorKey: 'id',
+  header: 'Count',
+  aggregateFn: count(),
+}
+```
+#### Defined in
+[packages/core/src/components/DataTable/utils/aggregationUtils.ts:88](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/DataTable/utils/aggregationUtils.ts#L88)
+___
+### min
+▸ **min**\<`TData`\>(`accessorKey`): \<TRow\>(`rows`: `TRow`[], `column`: [`DataTableColumn`](interfaces/DataTableColumn.md)\<`TRow`\>) => ``null`` \| `number`
+Creates a minimum aggregation function for a specific field.
+#### Type parameters
+| Name | Type |
+| :------ | :------ |
+| `TData` | extends [`DataRecord`](interfaces/DataRecord.md) = [`DataRecord`](interfaces/DataRecord.md) |
+#### Parameters
+| Name | Type | Description |
+| :------ | :------ | :------ |
+| `accessorKey` | `string` \| keyof `TData` | The field key to find the minimum of (e.g., 'price', 'date') |
+#### Returns
+`fn`
+An aggregation function that returns the minimum value of the specified field
+▸ \<`TRow`\>(`rows`, `column`): ``null`` \| `number`
+##### Type parameters
+| Name | Type |
+| :------ | :------ |
+| `TRow` | extends [`DataRecord`](interfaces/DataRecord.md) = `TData` |
+##### Parameters
+| Name | Type |
+| :------ | :------ |
+| `rows` | `TRow`[] |
+| `column` | [`DataTableColumn`](interfaces/DataTableColumn.md)\<`TRow`\> |
+##### Returns
+``null`` \| `number`
+**`Example`**
+```tsx
+{
+  accessorKey: 'price',
+  header: 'Min Price',
+  aggregateFn: min('price'),
+}
+```
+#### Defined in
+[packages/core/src/components/DataTable/utils/aggregationUtils.ts:109](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/DataTable/utils/aggregationUtils.ts#L109)
+___
+### max
+▸ **max**\<`TData`\>(`accessorKey`): \<TRow\>(`rows`: `TRow`[], `column`: [`DataTableColumn`](interfaces/DataTableColumn.md)\<`TRow`\>) => ``null`` \| `number`
+Creates a maximum aggregation function for a specific field.
+#### Type parameters
+| Name | Type |
+| :------ | :------ |
+| `TData` | extends [`DataRecord`](interfaces/DataRecord.md) = [`DataRecord`](interfaces/DataRecord.md) |
+#### Parameters
+| Name | Type | Description |
+| :------ | :------ | :------ |
+| `accessorKey` | `string` \| keyof `TData` | The field key to find the maximum of (e.g., 'price', 'date') |
+#### Returns
+`fn`
+An aggregation function that returns the maximum value of the specified field
+▸ \<`TRow`\>(`rows`, `column`): ``null`` \| `number`
+##### Type parameters
+| Name | Type |
+| :------ | :------ |
+| `TRow` | extends [`DataRecord`](interfaces/DataRecord.md) = `TData` |
+##### Parameters
+| Name | Type |
+| :------ | :------ |
+| `rows` | `TRow`[] |
+| `column` | [`DataTableColumn`](interfaces/DataTableColumn.md)\<`TRow`\> |
+##### Returns
+``null`` \| `number`
+**`Example`**
+```tsx
+{
+  accessorKey: 'price',
+  header: 'Max Price',
+  aggregateFn: max('price'),
+}
+```
+#### Defined in
+[packages/core/src/components/DataTable/utils/aggregationUtils.ts:143](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/DataTable/utils/aggregationUtils.ts#L143)
+___
 ### generateCSVContent
 ▸ **generateCSVContent**\<`TData`\>(`data`, `columns`, `options?`): `string`
@@ -1771,7 +2068,7 @@ This component provides secure event selection with:
 #### Defined in
-[packages/core/src/components/EventSelector/EventSelector.tsx:130](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/EventSelector/EventSelector.tsx#L130)
+[packages/core/src/components/EventSelector/EventSelector.tsx:131](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/EventSelector/EventSelector.tsx#L131)
 ___
@@ -1802,7 +2099,7 @@ React element with file display
 #### Defined in
-[packages/core/src/components/FileDisplay/FileDisplay.tsx:803](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/FileDisplay/FileDisplay.tsx#L803)
+[packages/core/src/components/FileDisplay/FileDisplay.tsx:769](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/FileDisplay/FileDisplay.tsx#L769)
 ___
@@ -2394,7 +2691,7 @@ function CustomNavigation() {
 #### Defined in
-[packages/core/src/components/NavigationMenu/NavigationMenu.tsx:397](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/NavigationMenu/NavigationMenu.tsx#L397)
+[packages/core/src/components/NavigationMenu/NavigationMenu.tsx:398](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/NavigationMenu/NavigationMenu.tsx#L398)
 ___
@@ -2425,7 +2722,7 @@ Security: Only shows organisations the user has valid access to
 #### Defined in
-[packages/core/src/components/OrganisationSelector/OrganisationSelector.tsx:96](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/OrganisationSelector/OrganisationSelector.tsx#L96)
+[packages/core/src/components/OrganisationSelector/OrganisationSelector.tsx:97](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/OrganisationSelector/OrganisationSelector.tsx#L97)
 ___
@@ -2596,7 +2893,7 @@ function AdminApp() {
 #### Defined in
-[packages/core/src/components/PaceAppLayout/PaceAppLayout.tsx:344](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/PaceAppLayout/PaceAppLayout.tsx#L344)
+[packages/core/src/components/PaceAppLayout/PaceAppLayout.tsx:345](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/PaceAppLayout/PaceAppLayout.tsx#L345)
 ___
@@ -2640,7 +2937,7 @@ JSX.Element - The rendered login page with enhanced functionality
 #### Defined in
-[packages/core/src/components/PaceLoginPage/PaceLoginPage.tsx:166](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/PaceLoginPage/PaceLoginPage.tsx#L166)
+[packages/core/src/components/PaceLoginPage/PaceLoginPage.tsx:167](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/PaceLoginPage/PaceLoginPage.tsx#L167)
 ___
@@ -2664,26 +2961,6 @@ ___
 ___
-### 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`
@@ -2745,7 +3022,80 @@ React element with route protection logic
 #### Defined in
-[packages/core/src/components/ProtectedRoute/ProtectedRoute.tsx:132](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/ProtectedRoute/ProtectedRoute.tsx#L132)
+[packages/core/src/components/ProtectedRoute/ProtectedRoute.tsx:133](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/ProtectedRoute/ProtectedRoute.tsx#L133)
+___
+### EventLogo
+▸ **EventLogo**(`props`): `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 uses FileDisplay internally to fetch and
+display 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
+`Element`
+React element with event logo or fallback
+#### Defined in
+[packages/core/src/components/PublicLayout/EventLogo.tsx:100](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/PublicLayout/EventLogo.tsx#L100)
+___
+### 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:154](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/PublicLayout/EventLogo.tsx#L154)
+___
+### 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:167](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/PublicLayout/EventLogo.tsx#L167)
 ___
@@ -2875,61 +3225,13 @@ Context checker component that immediately identifies authentication context iss
 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.
+Only enabled in development mode when VITE_ENABLE_DEBUG_LOGS is 'true'
 #### Parameters
 | Name | Type |
 | :------ | :------ |
-| `«destructured»` | `PublicPageDiagnosticProps` |
+| `«destructured»` | `PublicPageContextCheckerProps` |
 #### Returns
@@ -2937,7 +3239,7 @@ in your public page implementation.
 #### Defined in
-[packages/core/src/components/PublicLayout/PublicPageDiagnostic.tsx:27](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/PublicLayout/PublicPageDiagnostic.tsx#L27)
+[packages/core/src/components/PublicLayout/PublicPageContextChecker.tsx:30](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/PublicLayout/PublicPageContextChecker.tsx#L30)
 ___
@@ -3094,7 +3396,7 @@ This provider:
 #### Defined in
-[packages/core/src/components/PublicLayout/PublicPageProvider.tsx:70](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/PublicLayout/PublicPageProvider.tsx#L70)
+[packages/core/src/components/PublicLayout/PublicPageProvider.tsx:71](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/PublicLayout/PublicPageProvider.tsx#L71)
 ___
@@ -3112,7 +3414,7 @@ Public page context with environment variables
 #### Defined in
-[packages/core/src/components/PublicLayout/PublicPageProvider.tsx:128](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/PublicLayout/PublicPageProvider.tsx#L128)
+[packages/core/src/components/PublicLayout/PublicPageProvider.tsx:129](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/PublicLayout/PublicPageProvider.tsx#L129)
 ___
@@ -3130,7 +3432,7 @@ True if we're in a public page context
 #### Defined in
-[packages/core/src/components/PublicLayout/PublicPageProvider.tsx:143](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/PublicLayout/PublicPageProvider.tsx#L143)
+[packages/core/src/components/PublicLayout/PublicPageProvider.tsx:144](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/PublicLayout/PublicPageProvider.tsx#L144)
 ___
@@ -3302,7 +3604,7 @@ ___
 | Name | Type | Description |
 | :------ | :------ | :------ |
-| `props` | `SessionRestorationLoaderProps` | - |
+| `props` | [`SessionRestorationLoaderProps`](interfaces/SessionRestorationLoaderProps.md) | - |
 | `deprecatedLegacyContext?` | `any` | **`See`** [React Docs](https://legacy.reactjs.org/docs/legacy-context.html#referencing-context-in-lifecycle-methods) |
 #### Returns
@@ -3311,7 +3613,7 @@ ___
 #### Defined in
-[packages/core/src/components/SessionRestorationLoader.tsx:19](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/SessionRestorationLoader.tsx#L19)
+[packages/core/src/components/SessionRestorationLoader/SessionRestorationLoader.tsx:19](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/SessionRestorationLoader/SessionRestorationLoader.tsx#L19)
 ___
@@ -3931,7 +4233,7 @@ 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)
+[packages/core/src/hooks/public/usePublicEvent.ts:100](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/hooks/public/usePublicEvent.ts#L100)
 ___
@@ -3948,7 +4250,7 @@ Useful for testing or when you need to force refresh all data
 #### Defined in
-[packages/core/src/hooks/public/usePublicEvent.ts:410](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/hooks/public/usePublicEvent.ts#L410)
+[packages/core/src/hooks/public/usePublicEvent.ts:411](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/hooks/public/usePublicEvent.ts#L411)
 ___
@@ -3969,7 +4271,7 @@ Get cache statistics for debugging
 #### Defined in
-[packages/core/src/hooks/public/usePublicEvent.ts:421](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/hooks/public/usePublicEvent.ts#L421)
+[packages/core/src/hooks/public/usePublicEvent.ts:422](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/hooks/public/usePublicEvent.ts#L422)
 ___
@@ -4000,7 +4302,7 @@ Object containing file data, loading state, error, and refetch function
 #### Defined in
-[packages/core/src/hooks/public/usePublicFileDisplay.ts:89](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/hooks/public/usePublicFileDisplay.ts#L89)
+[packages/core/src/hooks/public/usePublicFileDisplay.ts:90](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/hooks/public/usePublicFileDisplay.ts#L90)
 ___
@@ -4017,7 +4319,7 @@ Useful for testing or when you need to force refresh all data
 #### Defined in
-[packages/core/src/hooks/public/usePublicFileDisplay.ts:542](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/hooks/public/usePublicFileDisplay.ts#L542)
+[packages/core/src/hooks/public/usePublicFileDisplay.ts:398](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/hooks/public/usePublicFileDisplay.ts#L398)
 ___
@@ -4038,7 +4340,7 @@ Get cache statistics for debugging
 #### Defined in
-[packages/core/src/hooks/public/usePublicFileDisplay.ts:553](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/hooks/public/usePublicFileDisplay.ts#L553)
+[packages/core/src/hooks/public/usePublicFileDisplay.ts:409](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/hooks/public/usePublicFileDisplay.ts#L409)
 ___
@@ -4277,7 +4579,7 @@ function PublicPageLayout({ event }) {
 #### Defined in
-[packages/core/src/hooks/useEventTheme.ts:92](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/hooks/useEventTheme.ts#L92)
+[packages/core/src/hooks/useEventTheme.ts:95](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/hooks/useEventTheme.ts#L95)
 ___
@@ -4317,7 +4619,7 @@ function MyComponent() {
 #### Defined in
-[packages/core/src/hooks/useEvents.ts:49](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/hooks/useEvents.ts#L49)
+[packages/core/src/hooks/useEvents.ts:50](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/hooks/useEvents.ts#L50)
 ___
@@ -4353,7 +4655,7 @@ ___
 #### Defined in
-[packages/core/src/hooks/useFileReference.ts:16](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/hooks/useFileReference.ts#L16)
+[packages/core/src/hooks/useFileReference.ts:19](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/hooks/useFileReference.ts#L19)
 ___
@@ -4392,7 +4694,7 @@ ___
 #### Defined in
-[packages/core/src/hooks/useFileReference.ts:199](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/hooks/useFileReference.ts#L199)
+[packages/core/src/hooks/useFileReference.ts:202](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/hooks/useFileReference.ts#L202)
 ___
@@ -4425,7 +4727,7 @@ Hook for getting a file reference by ID
 #### Defined in
-[packages/core/src/hooks/useFileReference.ts:301](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/hooks/useFileReference.ts#L301)
+[packages/core/src/hooks/useFileReference.ts:304](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/hooks/useFileReference.ts#L304)
 ___
@@ -4469,7 +4771,7 @@ For more control, use useFileReference() directly and manage URLs yourself.
 #### Defined in
-[packages/core/src/hooks/useFileReference.ts:374](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/hooks/useFileReference.ts#L374)
+[packages/core/src/hooks/useFileReference.ts:377](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/hooks/useFileReference.ts#L377)
 ___
@@ -4489,7 +4791,7 @@ ___
 #### Defined in
-[packages/core/src/hooks/useInactivityTracker.ts:127](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/hooks/useInactivityTracker.ts#L127)
+[packages/core/src/hooks/useInactivityTracker.ts:128](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/hooks/useInactivityTracker.ts#L128)
 ___
@@ -4527,7 +4829,7 @@ ___
 #### Defined in
-[packages/core/src/hooks/useOrganisationSecurity.ts:39](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/hooks/useOrganisationSecurity.ts#L39)
+[packages/core/src/hooks/useOrganisationSecurity.ts:40](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/hooks/useOrganisationSecurity.ts#L40)
 ___
@@ -4582,7 +4884,7 @@ ___
 #### Defined in
-[packages/core/src/hooks/useSessionRestoration.ts:25](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/hooks/useSessionRestoration.ts#L25)
+[packages/core/src/hooks/useSessionRestoration.ts:28](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/hooks/useSessionRestoration.ts#L28)
 ___
@@ -4626,7 +4928,7 @@ ___
 #### Defined in
-[packages/core/src/providers/services/EventServiceProvider.tsx:35](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/providers/services/EventServiceProvider.tsx#L35)
+[packages/core/src/providers/services/EventServiceProvider.tsx:36](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/providers/services/EventServiceProvider.tsx#L36)
 ___
@@ -4646,7 +4948,7 @@ ___
 #### Defined in
-[packages/core/src/providers/services/InactivityServiceProvider.tsx:32](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/providers/services/InactivityServiceProvider.tsx#L32)
+[packages/core/src/providers/services/InactivityServiceProvider.tsx:33](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/providers/services/InactivityServiceProvider.tsx#L33)
 ___
@@ -4666,7 +4968,7 @@ ___
 #### Defined in
-[packages/core/src/providers/services/OrganisationServiceProvider.tsx:29](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/providers/services/OrganisationServiceProvider.tsx#L29)
+[packages/core/src/providers/services/OrganisationServiceProvider.tsx:30](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/providers/services/OrganisationServiceProvider.tsx#L30)
 ___
@@ -4680,7 +4982,7 @@ ___
 #### Defined in
-[packages/core/src/providers/services/UnifiedAuthProvider.tsx:116](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/providers/services/UnifiedAuthProvider.tsx#L116)
+[packages/core/src/providers/services/UnifiedAuthProvider.tsx:117](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/providers/services/UnifiedAuthProvider.tsx#L117)
 ___
@@ -4700,7 +5002,7 @@ ___
 #### Defined in
-[packages/core/src/providers/services/UnifiedAuthProvider.tsx:514](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/providers/services/UnifiedAuthProvider.tsx#L514)
+[packages/core/src/providers/services/UnifiedAuthProvider.tsx:515](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/providers/services/UnifiedAuthProvider.tsx#L515)
 ___
@@ -5207,7 +5509,7 @@ Setup RBAC system
 #### Defined in
-[packages/core/src/rbac/api.ts:39](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/api.ts#L39)
+[packages/core/src/rbac/api.ts:42](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/api.ts#L42)
 ___
@@ -5242,7 +5544,7 @@ const accessLevel = await getAccessLevel({
 #### Defined in
-[packages/core/src/rbac/api.ts:90](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/api.ts#L90)
+[packages/core/src/rbac/api.ts:93](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/api.ts#L93)
 ___
@@ -5281,7 +5583,7 @@ const permissions = await getPermissionMap({
 #### Defined in
-[packages/core/src/rbac/api.ts:116](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/api.ts#L116)
+[packages/core/src/rbac/api.ts:119](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/api.ts#L119)
 ___
@@ -5303,7 +5605,7 @@ ___
 #### Defined in
-[packages/core/src/rbac/api.ts:124](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/api.ts#L124)
+[packages/core/src/rbac/api.ts:127](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/api.ts#L127)
 ___
@@ -5325,7 +5627,7 @@ ___
 #### Defined in
-[packages/core/src/rbac/api.ts:132](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/api.ts#L132)
+[packages/core/src/rbac/api.ts:135](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/api.ts#L135)
 ___
@@ -5360,7 +5662,7 @@ const canManage = await isPermitted({
 #### Defined in
-[packages/core/src/rbac/api.ts:156](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/api.ts#L156)
+[packages/core/src/rbac/api.ts:159](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/api.ts#L159)
 ___
@@ -5384,7 +5686,7 @@ Promise resolving to permission result
 #### Defined in
-[packages/core/src/rbac/api.ts:182](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/api.ts#L182)
+[packages/core/src/rbac/api.ts:185](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/api.ts#L185)
 ___
@@ -5408,7 +5710,7 @@ Promise<boolean> - True if user has permission
 #### Defined in
-[packages/core/src/rbac/api.ts:215](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/api.ts#L215)
+[packages/core/src/rbac/api.ts:218](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/api.ts#L218)
 ___
@@ -5436,7 +5738,7 @@ Promise resolving to true if user has any permission
 #### Defined in
-[packages/core/src/rbac/api.ts:225](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/api.ts#L225)
+[packages/core/src/rbac/api.ts:228](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/api.ts#L228)
 ___
@@ -5464,7 +5766,7 @@ Promise resolving to true if user has all permissions
 #### Defined in
-[packages/core/src/rbac/api.ts:253](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/api.ts#L253)
+[packages/core/src/rbac/api.ts:256](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/api.ts#L256)
 ___
@@ -5577,7 +5879,7 @@ React element with enhanced navigation menu
 #### Defined in
-[packages/core/src/rbac/components/EnhancedNavigationMenu.tsx:112](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/components/EnhancedNavigationMenu.tsx#L112)
+[packages/core/src/rbac/components/EnhancedNavigationMenu.tsx:113](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/components/EnhancedNavigationMenu.tsx#L113)
 ___
@@ -5605,7 +5907,7 @@ React element with navigation permission enforcement
 #### Defined in
-[packages/core/src/rbac/components/NavigationGuard.tsx:113](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/components/NavigationGuard.tsx#L113)
+[packages/core/src/rbac/components/NavigationGuard.tsx:114](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/components/NavigationGuard.tsx#L114)
 ___
@@ -5632,7 +5934,7 @@ React element with navigation permission context
 #### Defined in
-[packages/core/src/rbac/components/NavigationProvider.tsx:165](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/components/NavigationProvider.tsx#L165)
+[packages/core/src/rbac/components/NavigationProvider.tsx:167](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/components/NavigationProvider.tsx#L167)
 ___
@@ -5654,7 +5956,7 @@ Error if used outside of NavigationProvider
 #### Defined in
-[packages/core/src/rbac/components/NavigationProvider.tsx:328](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/components/NavigationProvider.tsx#L328)
+[packages/core/src/rbac/components/NavigationProvider.tsx:331](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/components/NavigationProvider.tsx#L331)
 ___
@@ -5682,7 +5984,7 @@ React element with permission enforcement
 #### Defined in
-[packages/core/src/rbac/components/PagePermissionGuard.tsx:534](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/components/PagePermissionGuard.tsx#L534)
+[packages/core/src/rbac/components/PagePermissionGuard.tsx:546](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/components/PagePermissionGuard.tsx#L546)
 ___
@@ -5709,7 +6011,7 @@ React element with page permission context
 #### Defined in
-[packages/core/src/rbac/components/PagePermissionProvider.tsx:125](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/components/PagePermissionProvider.tsx#L125)
+[packages/core/src/rbac/components/PagePermissionProvider.tsx:128](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/components/PagePermissionProvider.tsx#L128)
 ___
@@ -5731,7 +6033,7 @@ Error if used outside of PagePermissionProvider
 #### Defined in
-[packages/core/src/rbac/components/PagePermissionProvider.tsx:264](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/components/PagePermissionProvider.tsx#L264)
+[packages/core/src/rbac/components/PagePermissionProvider.tsx:267](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/components/PagePermissionProvider.tsx#L267)
 ___
@@ -5759,7 +6061,7 @@ React element with permission enforcement
 #### Defined in
-[packages/core/src/rbac/components/PermissionEnforcer.tsx:117](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/components/PermissionEnforcer.tsx#L117)
+[packages/core/src/rbac/components/PermissionEnforcer.tsx:121](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/components/PermissionEnforcer.tsx#L121)
 ___
@@ -5786,7 +6088,7 @@ React element with role-based routing
 #### Defined in
-[packages/core/src/rbac/components/RoleBasedRouter.tsx:181](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/components/RoleBasedRouter.tsx#L181)
+[packages/core/src/rbac/components/RoleBasedRouter.tsx:182](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/components/RoleBasedRouter.tsx#L182)
 ___
@@ -5808,7 +6110,7 @@ Error if used outside of RoleBasedRouter
 #### Defined in
-[packages/core/src/rbac/components/RoleBasedRouter.tsx:395](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/components/RoleBasedRouter.tsx#L395)
+[packages/core/src/rbac/components/RoleBasedRouter.tsx:397](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/components/RoleBasedRouter.tsx#L397)
 ___
@@ -5835,7 +6137,7 @@ React element with secure data context
 #### Defined in
-[packages/core/src/rbac/components/SecureDataProvider.tsx:135](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/components/SecureDataProvider.tsx#L135)
+[packages/core/src/rbac/components/SecureDataProvider.tsx:136](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/components/SecureDataProvider.tsx#L136)
 ___
@@ -5857,7 +6159,7 @@ Error if used outside of SecureDataProvider
 #### Defined in
-[packages/core/src/rbac/components/SecureDataProvider.tsx:309](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/components/SecureDataProvider.tsx#L309)
+[packages/core/src/rbac/components/SecureDataProvider.tsx:313](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/components/SecureDataProvider.tsx#L313)
 ___
@@ -5958,7 +6260,7 @@ RBACEngine instance
 #### Defined in
-[packages/core/src/rbac/engine.ts:613](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/engine.ts#L613)
+[packages/core/src/rbac/engine.ts:621](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/engine.ts#L621)
 ___
@@ -6011,7 +6313,7 @@ function MyComponent() {
 #### Defined in
-[packages/core/src/rbac/hooks/usePermissions.ts:49](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/hooks/usePermissions.ts#L49)
+[packages/core/src/rbac/hooks/usePermissions.ts:50](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/hooks/usePermissions.ts#L50)
 ___
@@ -6059,7 +6361,7 @@ function MyComponent() {
 #### Defined in
-[packages/core/src/rbac/hooks/usePermissions.ts:217](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/hooks/usePermissions.ts#L217)
+[packages/core/src/rbac/hooks/usePermissions.ts:220](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/hooks/usePermissions.ts#L220)
 ___
@@ -6109,7 +6411,7 @@ function MyComponent() {
 #### Defined in
-[packages/core/src/rbac/hooks/usePermissions.ts:375](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/hooks/usePermissions.ts#L375)
+[packages/core/src/rbac/hooks/usePermissions.ts:379](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/hooks/usePermissions.ts#L379)
 ___
@@ -6166,7 +6468,7 @@ function MyComponent() {
 #### Defined in
-[packages/core/src/rbac/hooks/usePermissions.ts:450](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/hooks/usePermissions.ts#L450)
+[packages/core/src/rbac/hooks/usePermissions.ts:454](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/hooks/usePermissions.ts#L454)
 ___
@@ -6217,7 +6519,7 @@ function MyComponent() {
 #### Defined in
-[packages/core/src/rbac/hooks/usePermissions.ts:533](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/hooks/usePermissions.ts#L533)
+[packages/core/src/rbac/hooks/usePermissions.ts:537](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/hooks/usePermissions.ts#L537)
 ___
@@ -6268,7 +6570,7 @@ function MyComponent() {
 #### Defined in
-[packages/core/src/rbac/hooks/usePermissions.ts:619](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/hooks/usePermissions.ts#L619)
+[packages/core/src/rbac/hooks/usePermissions.ts:623](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/hooks/usePermissions.ts#L623)
 ___
@@ -6319,7 +6621,7 @@ function MyComponent() {
 #### Defined in
-[packages/core/src/rbac/hooks/usePermissions.ts:704](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/hooks/usePermissions.ts#L704)
+[packages/core/src/rbac/hooks/usePermissions.ts:708](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/hooks/usePermissions.ts#L708)
 ___
@@ -6382,7 +6684,7 @@ const permission = useCan(userId, resolvedScope, permission);
 #### Defined in
-[packages/core/src/rbac/hooks/useResolvedScope.ts:61](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/hooks/useResolvedScope.ts#L61)
+[packages/core/src/rbac/hooks/useResolvedScope.ts:64](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/hooks/useResolvedScope.ts#L64)
 ___
@@ -6428,7 +6730,7 @@ True if valid, false otherwise
 #### Defined in
-[packages/core/src/rbac/permissions.ts:156](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/permissions.ts#L156)
+[packages/core/src/rbac/permissions.ts:159](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/permissions.ts#L159)
 ___
@@ -6467,7 +6769,7 @@ Empty array (function deprecated)
 #### Defined in
-[packages/core/src/rbac/permissions.ts:188](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/permissions.ts#L188)
+[packages/core/src/rbac/permissions.ts:191](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/permissions.ts#L191)
 ___
@@ -6627,7 +6929,7 @@ const palette = parseAndNormalizeEventColours(colours);
 #### Defined in
-[packages/core/src/theming/parseEventColours.ts:68](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/theming/parseEventColours.ts#L68)
+[packages/core/src/theming/parseEventColours.ts:54](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/theming/parseEventColours.ts#L54)
 ___
@@ -6650,7 +6952,7 @@ Uses document.documentElement.style.setProperty() for runtime updates.
 #### Defined in
-[packages/core/src/theming/runtime.ts:64](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/theming/runtime.ts#L64)
+[packages/core/src/theming/runtime.ts:70](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/theming/runtime.ts#L70)
 ___
@@ -6667,7 +6969,7 @@ This allows the browser to fall back to static CSS values.
 #### Defined in
-[packages/core/src/theming/runtime.ts:116](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/theming/runtime.ts#L116)
+[packages/core/src/theming/runtime.ts:120](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/theming/runtime.ts#L120)
 ___
@@ -6690,7 +6992,7 @@ Use this in your SSR setup to avoid FOUC
 #### Defined in
-[packages/core/src/theming/runtime.ts:194](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/theming/runtime.ts#L194)
+[packages/core/src/theming/runtime.ts:198](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/theming/runtime.ts#L198)
 ___
@@ -6706,7 +7008,7 @@ Checks if dynamic theming is currently active
 #### Defined in
-[packages/core/src/theming/runtime.ts:201](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/theming/runtime.ts#L201)
+[packages/core/src/theming/runtime.ts:205](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/theming/runtime.ts#L205)
 ___
@@ -6723,7 +7025,7 @@ Useful for debugging or persistence
 #### Defined in
-[packages/core/src/theming/runtime.ts:215](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/theming/runtime.ts#L215)
+[packages/core/src/theming/runtime.ts:219](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/theming/runtime.ts#L219)
 ___
@@ -6745,7 +7047,7 @@ Set the current application configuration
 #### Defined in
-[packages/core/src/utils/appConfig.ts:16](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/utils/appConfig.ts#L16)
+[packages/core/src/utils/app/appConfig.ts:16](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/utils/app/appConfig.ts#L16)
 ___
@@ -6761,7 +7063,7 @@ Get the current application configuration
 #### Defined in
-[packages/core/src/utils/appConfig.ts:23](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/utils/appConfig.ts#L23)
+[packages/core/src/utils/app/appConfig.ts:23](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/utils/app/appConfig.ts#L23)
 ___
@@ -6777,7 +7079,7 @@ Get the current app name
 #### Defined in
-[packages/core/src/utils/appConfig.ts:38](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/utils/appConfig.ts#L38)
+[packages/core/src/utils/app/appConfig.ts:38](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/utils/app/appConfig.ts#L38)
 ___
@@ -6793,7 +7095,40 @@ Get the current app ID
 #### Defined in
-[packages/core/src/utils/appConfig.ts:45](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/utils/appConfig.ts#L45)
+[packages/core/src/utils/app/appConfig.ts:45](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/utils/app/appConfig.ts#L45)
+___
+### useSessionTracking
+▸ **useSessionTracking**(`supabaseClient`, `appName?`): `Object`
+Hook for manual session tracking (event switches and session expiration).
+Note: Login and logout tracking is automatically handled by UnifiedAuthProvider.
+You should only use this hook for tracking event switches or session expirations.
+#### Parameters
+| Name | Type | Description |
+| :------ | :------ | :------ |
+| `supabaseClient` | `default`\<`any`, ``"public"``, ``"public"``, `any`, `any`\> | Supabase client instance |
+| `appName?` | `string` | Optional application name for tracking |
+#### Returns
+`Object`
+Object containing tracking functions for event switches and session expiration
+| Name | Type |
+| :------ | :------ |
+| `trackEventSwitch` | (`eventId`: `string`) => `Promise`\<`void`\> |
+| `trackSessionExpired` | () => `Promise`\<`void`\> |
+#### Defined in
+[packages/core/src/utils/context/sessionTracking.ts:25](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/utils/context/sessionTracking.ts#L25)
 ___
@@ -6813,7 +7148,7 @@ ___
 #### Defined in
-[packages/core/src/utils/cn.ts:5](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/utils/cn.ts#L5)
+[packages/core/src/utils/core/cn.ts:5](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/utils/core/cn.ts#L5)
 ___
@@ -6835,7 +7170,7 @@ Format a date as a readable string in "dd mmm yyyy" format (e.g., "15 Jun 2024")
 #### Defined in
-[packages/core/src/utils/formatting.ts:8](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/utils/formatting.ts#L8)
+[packages/core/src/utils/formatting/formatting.ts:8](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/utils/formatting/formatting.ts#L8)
 ___
@@ -6859,7 +7194,7 @@ Format a number as a currency
 #### Defined in
-[packages/core/src/utils/formatting.ts:24](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/utils/formatting.ts#L24)
+[packages/core/src/utils/formatting/formatting.ts:24](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/utils/formatting/formatting.ts#L24)
 ___
@@ -6883,7 +7218,7 @@ Format a number with custom options
 #### Defined in
-[packages/core/src/utils/formatting.ts:34](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/utils/formatting.ts#L34)
+[packages/core/src/utils/formatting/formatting.ts:34](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/utils/formatting/formatting.ts#L34)
 ___
@@ -6928,7 +7263,7 @@ formatPercent(0.8123, 'en-US', { preserveDecimals: true, maxDecimals: 2 }) // '0
 #### Defined in
-[packages/core/src/utils/formatting.ts:71](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/utils/formatting.ts#L71)
+[packages/core/src/utils/formatting/formatting.ts:71](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/utils/formatting/formatting.ts#L71)
 ___
@@ -6951,7 +7286,7 @@ Format a large number with abbreviations (K, M, B)
 #### Defined in
-[packages/core/src/utils/formatting.ts:115](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/utils/formatting.ts#L115)
+[packages/core/src/utils/formatting/formatting.ts:115](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/utils/formatting/formatting.ts#L115)
 ___
@@ -6973,7 +7308,7 @@ Format a file size in bytes to a human-readable string
 #### Defined in
-[packages/core/src/utils/formatting.ts:125](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/utils/formatting.ts#L125)
+[packages/core/src/utils/formatting/formatting.ts:125](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/utils/formatting/formatting.ts#L125)
 ___
@@ -6999,40 +7334,7 @@ Secure data access utilities
 #### Defined in
-[packages/core/src/utils/secureDataAccess.ts:76](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/utils/secureDataAccess.ts#L76)
-___
-### useSessionTracking
-▸ **useSessionTracking**(`supabaseClient`, `appName?`): `Object`
-Hook for manual session tracking (event switches and session expiration).
-Note: Login and logout tracking is automatically handled by UnifiedAuthProvider.
-You should only use this hook for tracking event switches or session expirations.
-#### Parameters
-| Name | Type | Description |
-| :------ | :------ | :------ |
-| `supabaseClient` | `default`\<`any`, ``"public"``, ``"public"``, `any`, `any`\> | Supabase client instance |
-| `appName?` | `string` | Optional application name for tracking |
-#### Returns
-`Object`
-Object containing tracking functions for event switches and session expiration
-| Name | Type |
-| :------ | :------ |
-| `trackEventSwitch` | (`eventId`: `string`) => `Promise`\<`void`\> |
-| `trackSessionExpired` | () => `Promise`\<`void`\> |
-#### Defined in
-[packages/core/src/utils/sessionTracking.ts:22](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/utils/sessionTracking.ts#L22)
+[packages/core/src/utils/security/secureDataAccess.ts:76](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/utils/security/secureDataAccess.ts#L76)
 ___
@@ -7128,7 +7430,7 @@ Generate a file path based on organization-first structure
 #### 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)
+[packages/core/src/utils/storage/helpers.ts:23](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/utils/storage/helpers.ts#L23)
 ___
@@ -7151,7 +7453,7 @@ Sanitizes the original filename to remove spaces and invalid characters for stor
 #### Defined in
-[packages/core/src/utils/storage/helpers.ts:51](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/utils/storage/helpers.ts#L51)
+[packages/core/src/utils/storage/helpers.ts:54](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/utils/storage/helpers.ts#L54)
 ___
@@ -7175,7 +7477,7 @@ Extract file metadata from a File object
 #### Defined in
-[packages/core/src/utils/storage/helpers.ts:78](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/utils/storage/helpers.ts#L78)
+[packages/core/src/utils/storage/helpers.ts:81](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/utils/storage/helpers.ts#L81)
 ___
@@ -7199,7 +7501,7 @@ Upload a file to Supabase storage with app segregation
 #### Defined in
-[packages/core/src/utils/storage/helpers.ts:152](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/utils/storage/helpers.ts#L152)
+[packages/core/src/utils/storage/helpers.ts:159](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/utils/storage/helpers.ts#L159)
 ___
@@ -7225,7 +7527,7 @@ Public URL for the file
 #### Defined in
-[packages/core/src/utils/storage/helpers.ts:224](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/utils/storage/helpers.ts#L224)
+[packages/core/src/utils/storage/helpers.ts:231](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/utils/storage/helpers.ts#L231)
 ___
@@ -7252,7 +7554,7 @@ Signed URL with expiration timestamp, or null if failed
 #### Defined in
-[packages/core/src/utils/storage/helpers.ts:320](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/utils/storage/helpers.ts#L320)
+[packages/core/src/utils/storage/helpers.ts:327](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/utils/storage/helpers.ts#L327)
 ___
@@ -7278,7 +7580,7 @@ Success status and optional error message
 #### Defined in
-[packages/core/src/utils/storage/helpers.ts:355](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/utils/storage/helpers.ts#L355)
+[packages/core/src/utils/storage/helpers.ts:362](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/utils/storage/helpers.ts#L362)
 ___
@@ -7303,7 +7605,7 @@ List of files with metadata
 #### Defined in
-[packages/core/src/utils/storage/helpers.ts:389](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/utils/storage/helpers.ts#L389)
+[packages/core/src/utils/storage/helpers.ts:396](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/utils/storage/helpers.ts#L396)
 ___
@@ -7329,7 +7631,7 @@ File blob with metadata, or null if failed
 #### Defined in
-[packages/core/src/utils/storage/helpers.ts:449](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/utils/storage/helpers.ts#L449)
+[packages/core/src/utils/storage/helpers.ts:456](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/utils/storage/helpers.ts#L456)
 ___
@@ -7356,4 +7658,4 @@ Move a file to archived location (soft delete)
 #### Defined in
-[packages/core/src/utils/storage/helpers.ts:502](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/utils/storage/helpers.ts#L502)
+[packages/core/src/utils/storage/helpers.ts:509](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/utils/storage/helpers.ts#L509)