@jmruthers/pace-core 0.5.75 → 0.5.76

package/docs/api/interfaces/UsePublicEventOptions.md

@@ -1,4 +1,4 @@
-[@jmruthers/pace-core - v0.5.75](../README.md) / [Exports](../modules.md) / UsePublicEventOptions
+[@jmruthers/pace-core - v0.5.76](../README.md) / [Exports](../modules.md) / UsePublicEventOptions
 
 # Interface: UsePublicEventOptions
 

package/docs/api/interfaces/UsePublicEventReturn.md

@@ -1,4 +1,4 @@
-[@jmruthers/pace-core - v0.5.75](../README.md) / [Exports](../modules.md) / UsePublicEventReturn
+[@jmruthers/pace-core - v0.5.76](../README.md) / [Exports](../modules.md) / UsePublicEventReturn
 
 # Interface: UsePublicEventReturn
 

package/docs/api/interfaces/UsePublicRouteParamsReturn.md

@@ -1,4 +1,4 @@
-[@jmruthers/pace-core - v0.5.75](../README.md) / [Exports](../modules.md) / UsePublicRouteParamsReturn
+[@jmruthers/pace-core - v0.5.76](../README.md) / [Exports](../modules.md) / UsePublicRouteParamsReturn
 
 # Interface: UsePublicRouteParamsReturn
 

package/docs/api/interfaces/UseResolvedScopeOptions.md

@@ -0,0 +1,47 @@
+[@jmruthers/pace-core - v0.5.76](../README.md) / [Exports](../modules.md) / UseResolvedScopeOptions
+
+# Interface: UseResolvedScopeOptions
+
+## Table of contents
+
+### Properties
+
+- [supabase](UseResolvedScopeOptions.md#supabase)
+- [selectedOrganisationId](UseResolvedScopeOptions.md#selectedorganisationid)
+- [selectedEventId](UseResolvedScopeOptions.md#selectedeventid)
+
+## Properties
+
+### supabase
+
+• **supabase**: ``null`` \| `default`\<`Database`, ``"public"``, ``"public"``, `never`, {}\>
+
+Supabase client instance
+
+#### Defined in
+
+[packages/core/src/rbac/hooks/useResolvedScope.ts:21](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/hooks/useResolvedScope.ts#L21)
+
+___
+
+### selectedOrganisationId
+
+• **selectedOrganisationId**: ``null`` \| `string`
+
+Selected organisation ID
+
+#### Defined in
+
+[packages/core/src/rbac/hooks/useResolvedScope.ts:23](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/hooks/useResolvedScope.ts#L23)
+
+___
+
+### selectedEventId
+
+• **selectedEventId**: ``null`` \| `string`
+
+Selected event ID
+
+#### Defined in
+
+[packages/core/src/rbac/hooks/useResolvedScope.ts:25](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/hooks/useResolvedScope.ts#L25)

package/docs/api/interfaces/UseResolvedScopeReturn.md

@@ -0,0 +1,47 @@
+[@jmruthers/pace-core - v0.5.76](../README.md) / [Exports](../modules.md) / UseResolvedScopeReturn
+
+# Interface: UseResolvedScopeReturn
+
+## Table of contents
+
+### Properties
+
+- [resolvedScope](UseResolvedScopeReturn.md#resolvedscope)
+- [isLoading](UseResolvedScopeReturn.md#isloading)
+- [error](UseResolvedScopeReturn.md#error)
+
+## Properties
+
+### resolvedScope
+
+• **resolvedScope**: ``null`` \| [`Scope`](../modules.md#scope)
+
+Resolved scope, or null if not yet resolved
+
+#### Defined in
+
+[packages/core/src/rbac/hooks/useResolvedScope.ts:30](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/hooks/useResolvedScope.ts#L30)
+
+___
+
+### isLoading
+
+• **isLoading**: `boolean`
+
+Whether the scope resolution is in progress
+
+#### Defined in
+
+[packages/core/src/rbac/hooks/useResolvedScope.ts:32](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/hooks/useResolvedScope.ts#L32)
+
+___
+
+### error
+
+• **error**: ``null`` \| `Error`
+
+Error if scope resolution failed
+
+#### Defined in
+
+[packages/core/src/rbac/hooks/useResolvedScope.ts:34](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/hooks/useResolvedScope.ts#L34)

package/docs/api/interfaces/UserEventAccess.md

@@ -1,4 +1,4 @@
-[@jmruthers/pace-core - v0.5.75](../README.md) / [Exports](../modules.md) / UserEventAccess
+[@jmruthers/pace-core - v0.5.76](../README.md) / [Exports](../modules.md) / UserEventAccess
 
 # Interface: UserEventAccess
 

package/docs/api/interfaces/UserMenuProps.md

@@ -1,4 +1,4 @@
-[@jmruthers/pace-core - v0.5.75](../README.md) / [Exports](../modules.md) / UserMenuProps
+[@jmruthers/pace-core - v0.5.76](../README.md) / [Exports](../modules.md) / UserMenuProps
 
 # Interface: UserMenuProps
 

package/docs/api/interfaces/UserProfile.md

@@ -1,4 +1,4 @@
-[@jmruthers/pace-core - v0.5.75](../README.md) / [Exports](../modules.md) / UserProfile
+[@jmruthers/pace-core - v0.5.76](../README.md) / [Exports](../modules.md) / UserProfile
 
 # Interface: UserProfile
 

package/docs/api/modules.md

@@ -1,6 +1,6 @@
-[@jmruthers/pace-core - v0.5.75](README.md) / Exports
+[@jmruthers/pace-core - v0.5.76](README.md) / Exports
 
-# @jmruthers/pace-core - v0.5.75
+# @jmruthers/pace-core - v0.5.76
 
 **`File`**
 
@@ -110,6 +110,8 @@ import { Dialog, NavigationMenu } from '@jmruthers/pace-core/components';
 - [SecureDataProviderProps](interfaces/SecureDataProviderProps.md)
 - [RBACConfig](interfaces/RBACConfig.md)
 - [RBACLogger](interfaces/RBACLogger.md)
+- [UseResolvedScopeOptions](interfaces/UseResolvedScopeOptions.md)
+- [UseResolvedScopeReturn](interfaces/UseResolvedScopeReturn.md)
 - [RBACContextType](interfaces/RBACContextType.md)
 - [RBACProviderProps](interfaces/RBACProviderProps.md)
 - [UserEventAccess](interfaces/UserEventAccess.md)
@@ -346,6 +348,7 @@ import { Dialog, NavigationMenu } from '@jmruthers/pace-core/components';
 - [useHasAllPermissions](modules.md#usehasallpermissions)
 - [useCachedPermissions](modules.md#usecachedpermissions)
 - [useRBAC](modules.md#userbac)
+- [useResolvedScope](modules.md#useresolvedscope)
 - [isValidPermission](modules.md#isvalidpermission)
 - [getPermissionsForRole](modules.md#getpermissionsforrole)
 - [useRBACProvider](modules.md#userbacprovider)
@@ -2996,7 +2999,7 @@ ___
 
 | Name | Type |
 | :------ | :------ |
-| `props` | `SelectProps` & `RefAttributes`\<`HTMLFormElement`\> |
+| `props` | `SelectProps` & `UseSelectStateProps` & `RefAttributes`\<`HTMLFormElement`\> |
 
 #### Returns
 
@@ -3004,7 +3007,7 @@ ___
 
 #### Defined in
 
-[packages/core/src/components/Select/Select.tsx:96](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Select/Select.tsx#L96)
+[packages/core/src/components/Select/Select.tsx:87](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Select/Select.tsx#L87)
 
 ___
 
@@ -3024,7 +3027,7 @@ ___
 
 #### Defined in
 
-[packages/core/src/components/Select/Select.tsx:275](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Select/Select.tsx#L275)
+[packages/core/src/components/Select/Select.tsx:147](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Select/Select.tsx#L147)
 
 ___
 
@@ -3044,7 +3047,7 @@ ___
 
 #### Defined in
 
-[packages/core/src/components/Select/Select.tsx:398](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Select/Select.tsx#L398)
+[packages/core/src/components/Select/Select.tsx:270](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Select/Select.tsx#L270)
 
 ___
 
@@ -3064,7 +3067,7 @@ ___
 
 #### Defined in
 
-[packages/core/src/components/Select/Select.tsx:415](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Select/Select.tsx#L415)
+[packages/core/src/components/Select/Select.tsx:287](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Select/Select.tsx#L287)
 
 ___
 
@@ -3084,7 +3087,7 @@ ___
 
 #### Defined in
 
-[packages/core/src/components/Select/Select.tsx:545](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Select/Select.tsx#L545)
+[packages/core/src/components/Select/Select.tsx:378](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Select/Select.tsx#L378)
 
 ___
 
@@ -3104,7 +3107,7 @@ ___
 
 #### Defined in
 
-[packages/core/src/components/Select/Select.tsx:630](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Select/Select.tsx#L630)
+[packages/core/src/components/Select/Select.tsx:465](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Select/Select.tsx#L465)
 
 ___
 
@@ -3124,7 +3127,7 @@ ___
 
 #### Defined in
 
-[packages/core/src/components/Select/Select.tsx:641](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Select/Select.tsx#L641)
+[packages/core/src/components/Select/Select.tsx:476](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Select/Select.tsx#L476)
 
 ___
 
@@ -3144,7 +3147,7 @@ ___
 
 #### Defined in
 
-[packages/core/src/components/Select/Select.tsx:652](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Select/Select.tsx#L652)
+[packages/core/src/components/Select/Select.tsx:487](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Select/Select.tsx#L487)
 
 ___
 
@@ -6063,6 +6066,49 @@ ___
 
 ___
 
+### useResolvedScope
+
+▸ **useResolvedScope**(`options`): [`UseResolvedScopeReturn`](interfaces/UseResolvedScopeReturn.md)
+
+Resolves RBAC scope from organisation and event context
+
+This hook handles the complex logic of determining the correct RBAC scope
+based on available context (organisation, event, app). It ensures consistent
+scope resolution across the application.
+
+#### Parameters
+
+| Name | Type | Description |
+| :------ | :------ | :------ |
+| `options` | [`UseResolvedScopeOptions`](interfaces/UseResolvedScopeOptions.md) | Hook options |
+
+#### Returns
+
+[`UseResolvedScopeReturn`](interfaces/UseResolvedScopeReturn.md)
+
+Resolved scope and loading state
+
+**`Example`**
+
+```tsx
+const { resolvedScope, isLoading } = useResolvedScope({
+  supabase,
+  selectedOrganisationId,
+  selectedEventId
+});
+
+if (isLoading) return <Loading />;
+if (!resolvedScope) return <Error />;
+
+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)
+
+___
+
 ### isValidPermission
 
 ▸ **isValidPermission**(`permission`): permission is \`read:$\{string}\` \| \`create:$\{string}\` \| \`update:$\{string}\` \| \`delete:$\{string}\`

package/docs/api-reference/providers.md

@@ -52,10 +52,9 @@ function App() {
       appName="my-app"
       enableRBAC={true}
       requireOrganisationContext={true}
-      // Required inactivity configuration
-      idleTimeoutMs={30 * 60 * 1000}  // 30 minutes
-      warnBeforeMs={5 * 60 * 1000}    // 5 minutes warning
-      onIdleLogout={() => navigate('/login')}
+      idleTimeoutMs={30 * 60 * 1000}  // Required: 30 minutes
+      warnBeforeMs={5 * 60 * 1000}    // Required: 5 minutes warning
+      onIdleLogout={() => navigate('/login')}  // Required
     >
       <AppContent />
     </UnifiedAuthProvider>
@@ -111,6 +110,8 @@ function App() {
     <UnifiedAuthProvider
       supabaseClient={supabase}
       appName="my-app"
+      idleTimeoutMs={30 * 60 * 1000}
+      warnBeforeMs={60 * 1000}
       onIdleLogout={() => navigate('/login')}
     >
       <AppContent />
@@ -228,7 +229,13 @@ import { OrganisationProvider } from '@jmruthers/pace-core';
 
 function App() {
   return (
-    <UnifiedAuthProvider supabaseClient={supabase} appName="my-app">
+    <UnifiedAuthProvider 
+      supabaseClient={supabase} 
+      appName="my-app"
+      idleTimeoutMs={30 * 60 * 1000}
+      warnBeforeMs={60 * 1000}
+      onIdleLogout={() => window.location.href = '/login'}
+    >
       <OrganisationProvider
         requireOrganisationContext={true}
         autoSelectPrimaryOrganisation={true}
@@ -294,7 +301,13 @@ import { EventProvider } from '@jmruthers/pace-core';
 
 function App() {
   return (
-    <UnifiedAuthProvider supabaseClient={supabase} appName="my-app">
+    <UnifiedAuthProvider 
+      supabaseClient={supabase} 
+      appName="my-app"
+      idleTimeoutMs={30 * 60 * 1000}
+      warnBeforeMs={60 * 1000}
+      onIdleLogout={() => window.location.href = '/login'}
+    >
       <OrganisationProvider>
         <EventProvider
           defaultEventId="optional-default-event-id"
@@ -371,7 +384,13 @@ function App() {
 function App() {
   return (
     <ErrorBoundary>
-      <UnifiedAuthProvider supabaseClient={supabase} appName="my-app">
+      <UnifiedAuthProvider 
+        supabaseClient={supabase} 
+        appName="my-app"
+        idleTimeoutMs={30 * 60 * 1000}
+        warnBeforeMs={60 * 1000}
+        onIdleLogout={() => window.location.href = '/login'}
+      >
         <OrganisationProvider>
           <EventProvider>
             <AppContent />

package/docs/best-practices/README.md

@@ -16,6 +16,26 @@ Comprehensive best practices for building secure, performant, and maintainable a
 - [Accessibility](#-accessibility)
 - [Maintenance](#-maintenance)
 
+## Core Topics
+
+### Security
+- [**Security Best Practices**](./security.md) - Security guidelines and secure coding patterns
+
+### Accessibility  
+- [**Accessibility Guide**](./accessibility.md) - WCAG compliance and inclusive design
+
+### Performance
+- [**Performance Optimization**](./performance.md) - Basic optimization strategies
+- [**Advanced Performance**](./performance-expansion.md) - Advanced optimization techniques
+
+### Testing
+- [**Testing Best Practices**](./testing.md) - Testing strategies and patterns
+
+### Deployment
+- [**Deployment Guide**](./deployment.md) - Production deployment guidelines
+
+---
+
 ## 🔒 Security Best Practices
 
 ### Authentication & Authorization