@jmruthers/pace-core 0.6.1 → 0.6.3

package/docs/api/interfaces/UseResolvedScopeReturn.md

@@ -1,47 +0,0 @@
-[@jmruthers/pace-core - v0.5.192](../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:44](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/hooks/useResolvedScope.ts#L44)
-
-___
-
-### isLoading
-
-• **isLoading**: `boolean`
-
-Whether the scope resolution is in progress
-
-#### Defined in
-
-[packages/core/src/rbac/hooks/useResolvedScope.ts:46](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/hooks/useResolvedScope.ts#L46)
-
-___
-
-### error
-
-• **error**: ``null`` \| `Error`
-
-Error if scope resolution failed
-
-#### Defined in
-
-[packages/core/src/rbac/hooks/useResolvedScope.ts:48](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/hooks/useResolvedScope.ts#L48)

package/docs/api/interfaces/UseResourcePermissionsOptions.md

@@ -1,34 +0,0 @@
-[@jmruthers/pace-core - v0.5.192](../README.md) / [Exports](../modules.md) / UseResourcePermissionsOptions
-
-# Interface: UseResourcePermissionsOptions
-
-## Table of contents
-
-### Properties
-
-- [enableRead](UseResourcePermissionsOptions.md#enableread)
-- [requireScope](UseResourcePermissionsOptions.md#requirescope)
-
-## Properties
-
-### enableRead
-
-• `Optional` **enableRead**: `boolean`
-
-Whether to check read permissions (default: false)
-
-#### Defined in
-
-[packages/core/src/rbac/hooks/useResourcePermissions.ts:53](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/hooks/useResourcePermissions.ts#L53)
-
-___
-
-### requireScope
-
-• `Optional` **requireScope**: `boolean`
-
-Whether scope resolution is required (default: true)
-
-#### Defined in
-
-[packages/core/src/rbac/hooks/useResourcePermissions.ts:55](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/hooks/useResourcePermissions.ts#L55)

package/docs/api/interfaces/UserEventAccess.md

@@ -1,118 +0,0 @@
-[@jmruthers/pace-core - v0.5.192](../README.md) / [Exports](../modules.md) / UserEventAccess
-
-# Interface: UserEventAccess
-
-## Table of contents
-
-### Properties
-
-- [event\_id](UserEventAccess.md#event_id)
-- [event\_name](UserEventAccess.md#event_name)
-- [event\_description](UserEventAccess.md#event_description)
-- [start\_date](UserEventAccess.md#start_date)
-- [end\_date](UserEventAccess.md#end_date)
-- [event\_status](UserEventAccess.md#event_status)
-- [app\_id](UserEventAccess.md#app_id)
-- [access\_level](UserEventAccess.md#access_level)
-- [granted\_at](UserEventAccess.md#granted_at)
-- [organisation\_id](UserEventAccess.md#organisation_id)
-
-## Properties
-
-### event\_id
-
-• **event\_id**: `string`
-
-#### Defined in
-
-[packages/core/src/providers/services/UnifiedAuthProvider.tsx:31](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/providers/services/UnifiedAuthProvider.tsx#L31)
-
-___
-
-### event\_name
-
-• **event\_name**: `string`
-
-#### Defined in
-
-[packages/core/src/providers/services/UnifiedAuthProvider.tsx:32](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/providers/services/UnifiedAuthProvider.tsx#L32)
-
-___
-
-### event\_description
-
-• `Optional` **event\_description**: ``null`` \| `string`
-
-#### Defined in
-
-[packages/core/src/providers/services/UnifiedAuthProvider.tsx:33](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/providers/services/UnifiedAuthProvider.tsx#L33)
-
-___
-
-### start\_date
-
-• **start\_date**: `string`
-
-#### Defined in
-
-[packages/core/src/providers/services/UnifiedAuthProvider.tsx:34](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/providers/services/UnifiedAuthProvider.tsx#L34)
-
-___
-
-### end\_date
-
-• **end\_date**: `string`
-
-#### Defined in
-
-[packages/core/src/providers/services/UnifiedAuthProvider.tsx:35](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/providers/services/UnifiedAuthProvider.tsx#L35)
-
-___
-
-### event\_status
-
-• **event\_status**: `string`
-
-#### Defined in
-
-[packages/core/src/providers/services/UnifiedAuthProvider.tsx:36](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/providers/services/UnifiedAuthProvider.tsx#L36)
-
-___
-
-### app\_id
-
-• **app\_id**: `string`
-
-#### Defined in
-
-[packages/core/src/providers/services/UnifiedAuthProvider.tsx:37](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/providers/services/UnifiedAuthProvider.tsx#L37)
-
-___
-
-### access\_level
-
-• **access\_level**: `string`
-
-#### Defined in
-
-[packages/core/src/providers/services/UnifiedAuthProvider.tsx:38](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/providers/services/UnifiedAuthProvider.tsx#L38)
-
-___
-
-### granted\_at
-
-• **granted\_at**: `string`
-
-#### Defined in
-
-[packages/core/src/providers/services/UnifiedAuthProvider.tsx:39](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/providers/services/UnifiedAuthProvider.tsx#L39)
-
-___
-
-### organisation\_id
-
-• **organisation\_id**: `string`
-
-#### Defined in
-
-[packages/core/src/providers/services/UnifiedAuthProvider.tsx:40](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/providers/services/UnifiedAuthProvider.tsx#L40)

package/docs/api/interfaces/UserMenuProps.md

@@ -1,86 +0,0 @@
-[@jmruthers/pace-core - v0.5.192](../README.md) / [Exports](../modules.md) / UserMenuProps
-
-# Interface: UserMenuProps
-
-## Table of contents
-
-### Properties
-
-- [user](UserMenuProps.md#user)
-- [onSignOut](UserMenuProps.md#onsignout)
-- [onChangePassword](UserMenuProps.md#onchangepassword)
-- [className](UserMenuProps.md#classname)
-- [showAvatar](UserMenuProps.md#showavatar)
-
-## Properties
-
-### user
-
-• **user**: ``null`` \| `User`
-
-#### Defined in
-
-[packages/core/src/components/UserMenu/UserMenu.tsx:129](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/UserMenu/UserMenu.tsx#L129)
-
-___
-
-### onSignOut
-
-• `Optional` **onSignOut**: () => `Promise`\<`void`\>
-
-#### Type declaration
-
-▸ (): `Promise`\<`void`\>
-
-##### Returns
-
-`Promise`\<`void`\>
-
-#### Defined in
-
-[packages/core/src/components/UserMenu/UserMenu.tsx:130](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/UserMenu/UserMenu.tsx#L130)
-
-___
-
-### onChangePassword
-
-• `Optional` **onChangePassword**: (`newPassword`: `string`, `confirmPassword`: `string`) => `Promise`\<\{ `error?`: `PasswordChangeFormError`  }\>
-
-#### Type declaration
-
-▸ (`newPassword`, `confirmPassword`): `Promise`\<\{ `error?`: `PasswordChangeFormError`  }\>
-
-##### Parameters
-
-| Name | Type |
-| :------ | :------ |
-| `newPassword` | `string` |
-| `confirmPassword` | `string` |
-
-##### Returns
-
-`Promise`\<\{ `error?`: `PasswordChangeFormError`  }\>
-
-#### Defined in
-
-[packages/core/src/components/UserMenu/UserMenu.tsx:131](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/UserMenu/UserMenu.tsx#L131)
-
-___
-
-### className
-
-• `Optional` **className**: `string`
-
-#### Defined in
-
-[packages/core/src/components/UserMenu/UserMenu.tsx:132](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/UserMenu/UserMenu.tsx#L132)
-
-___
-
-### showAvatar
-
-• `Optional` **showAvatar**: `boolean`
-
-#### Defined in
-
-[packages/core/src/components/UserMenu/UserMenu.tsx:133](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/UserMenu/UserMenu.tsx#L133)

package/docs/api/interfaces/UserProfile.md

@@ -1,63 +0,0 @@
-[@jmruthers/pace-core - v0.5.192](../README.md) / [Exports](../modules.md) / UserProfile
-
-# Interface: UserProfile
-
-## Table of contents
-
-### Properties
-
-- [id](UserProfile.md#id)
-- [email](UserProfile.md#email)
-- [full\_name](UserProfile.md#full_name)
-- [created\_at](UserProfile.md#created_at)
-- [updated\_at](UserProfile.md#updated_at)
-
-## Properties
-
-### id
-
-• **id**: `UserId`
-
-#### Defined in
-
-[packages/core/src/types/organisation.ts:43](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/types/organisation.ts#L43)
-
-___
-
-### email
-
-• **email**: `string`
-
-#### Defined in
-
-[packages/core/src/types/organisation.ts:44](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/types/organisation.ts#L44)
-
-___
-
-### full\_name
-
-• `Optional` **full\_name**: `string`
-
-#### Defined in
-
-[packages/core/src/types/organisation.ts:45](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/types/organisation.ts#L45)
-
-___
-
-### created\_at
-
-• **created\_at**: `string`
-
-#### Defined in
-
-[packages/core/src/types/organisation.ts:46](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/types/organisation.ts#L46)
-
-___
-
-### updated\_at
-
-• **updated\_at**: `string`
-
-#### Defined in
-
-[packages/core/src/types/organisation.ts:47](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/types/organisation.ts#L47)

package/docs/migration/quick-migration-guide.md

@@ -1,356 +0,0 @@
----
-lastUpdated: 2025-11-18T21:00:00+11:00
-version: 0.5.181
-reviewedBy: documentation-standards-audit
----
-
-# Quick Migration Guide
-
-> **🚀 Fast Track Migration** | [Full Migration Guide](./MIGRATION_GUIDE.md) | [Complete Migration Reference](./README.md)
-
-Quick migration guide for common PACE Core upgrade scenarios. For detailed migration instructions, see the [Complete Migration Guide](./MIGRATION_GUIDE.md).
-
-## 🎯 Quick Migration Checklist
-
-### Before You Start
-- [ ] **Backup your project** - Always backup before major updates
-- [ ] **Check current version** - `npm list @jmruthers/pace-core`
-- [ ] **Review changelog** - Check for breaking changes
-- [ ] **Test in development** - Never migrate directly in production
-
-### Common Migration Scenarios
-
-## 📦 Package Updates
-
-### Minor Version Updates (e.g., v0.4.16 → v0.4.17)
-
-**Usually safe, but check for:**
-- New features
-- Bug fixes
-- Performance improvements
-
-```bash
-# Update to latest
-npm update @jmruthers/pace-core
-
-# Or specific version
-npm install @jmruthers/pace-core@0.4.17
-```
-
-**What to check:**
-- [ ] App still builds successfully
-- [ ] No console errors
-- [ ] Components render correctly
-- [ ] Authentication still works
-
-### Major Version Updates (e.g., v0.x → v1.x)
-
-**Requires more attention:**
-- Breaking API changes
-- New required props
-- Deprecated features
-- Configuration changes
-
-```bash
-# Check what's new
-npm info @jmruthers/pace-core versions --json
-
-# Update to latest
-npm install @jmruthers/pace-core@latest
-```
-
-**What to check:**
-- [ ] Review [Breaking Changes](./breaking-changes.md)
-- [ ] Update import statements
-- [ ] Fix deprecated API usage
-- [ ] Update configuration files
-- [ ] Test all functionality
-
-## 🔧 Configuration Updates
-
-### Tailwind v4 Migration
-
-**From v0.4.15 to v0.4.16+ (CSS-First Approach):**
-
-```bash
-# Remove old dependencies
-npm uninstall tailwindcss postcss autoprefixer
-
-# Install new dependencies
-npm install @tailwindcss/vite tailwindcss@^4.0.0
-```
-
-**Update vite.config.ts:**
-```ts
-// Before (v0.4.15)
-import tailwindcss from '@tailwindcss/vite'
-export default defineConfig({
-  plugins: [
-    react(),
-    tailwindcss({
-      content: [
-        './src/**/*.{js,ts,jsx,tsx}',
-        './node_modules/@jmruthers/pace-core/src/**/*.{js,ts,jsx,tsx}'
-      ]
-    })
-  ],
-})
-
-// After (v0.4.16+)
-import tailwindcss from '@tailwindcss/vite'
-export default defineConfig({
-  plugins: [
-    react(),
-    tailwindcss({
-      content: [
-        './src/**/*.{js,ts,jsx,tsx}' // Only app files, pace-core scanned via @source
-      ]
-    })
-  ],
-})
-```
-
-**Update CSS imports:**
-```tsx
-// Before
-import '@jmruthers/pace-core/src/styles/core.css';
-
-// After
-import '@jmruthers/pace-core/src/styles/core.css';
-```
-
-### Source Path Fix (v0.4.17+)
-
-**Critical fix for @source directive paths:**
-
-```ts
-// vite.config.ts
-import tailwindcss from '@tailwindcss/vite'
-export default defineConfig({
-  plugins: [
-    react(),
-    tailwindcss({
-      content: [
-        './src/**/*.{js,ts,jsx,tsx}',
-        './node_modules/@jmruthers/pace-core/**/*.{js,ts,jsx,tsx}'
-      ]
-    })
-  ],
-})
-```
-
-## 🔄 API Changes
-
-### Component Props
-
-**Common prop changes:**
-
-```tsx
-// Before (v0.x)
-<DataTable
-  data={data}
-  columns={columns}
-  enableSearch={true}
-  enablePagination={true}
-/>
-
-// After (v1.x)
-<DataTable
-  data={data}
-  columns={columns}
-  features={{
-    search: true,
-    pagination: true,
-    sorting: true,
-    filtering: true
-  }}
-/>
-```
-
-### Hook Changes
-
-**RBAC hooks moved to separate module:**
-
-```tsx
-// Before
-import { useCan, usePermissions } from '@jmruthers/pace-core';
-
-// After
-import { useCan, usePermissions } from '@jmruthers/pace-core/rbac';
-```
-
-### Import Changes
-
-**Consolidated imports:**
-
-```tsx
-// Before
-import { Button } from '@jmruthers/pace-core/components';
-import { useUnifiedAuth } from '@jmruthers/pace-core/hooks';
-
-// After
-import { Button, useUnifiedAuth } from '@jmruthers/pace-core';
-```
-
-## 🐛 Common Migration Issues
-
-### Styling Issues
-
-**Problem**: Components appear unstyled after update
-
-**Solution**:
-```tsx
-// Ensure CSS import is first
-import '@jmruthers/pace-core/src/styles/core.css';
-import { Button } from '@jmruthers/pace-core';
-```
-
-### Build Errors
-
-**Problem**: Build fails with Tailwind errors
-
-**Solution**:
-```bash
-# Clear all caches
-rm -rf node_modules package-lock.json
-npm install
-
-# Check Tailwind config
-npm run build -- --debug
-```
-
-### TypeScript Errors
-
-**Problem**: Type errors after update
-
-**Solution**:
-```bash
-# Update TypeScript types
-npm install @types/react@latest @types/react-dom@latest
-
-# Regenerate types
-npm run type-check
-```
-
-### Authentication Issues
-
-**Problem**: Login not working after update
-
-**Solution**:
-```tsx
-// Check provider hierarchy
-<UnifiedAuthProvider supabaseClient={supabase} appName="my-app">
-  <OrganisationProvider>
-    <EventProvider>
-      <YourApp />
-    </EventProvider>
-  </OrganisationProvider>
-</UnifiedAuthProvider>
-```
-
-## ✅ Post-Migration Testing
-
-### Essential Tests
-- [ ] **Build succeeds** - `npm run build`
-- [ ] **App starts** - `npm run dev`
-- [ ] **Authentication works** - Login/logout
-- [ ] **Components render** - All UI components display
-- [ ] **Permissions work** - RBAC functions correctly
-- [ ] **Forms work** - Form validation and submission
-- [ ] **Data tables work** - CRUD operations
-- [ ] **Styling correct** - No visual regressions
-
-### Performance Tests
-- [ ] **Bundle size** - Check for size increases
-- [ ] **Load time** - Measure initial load
-- [ ] **Runtime performance** - Check for slowdowns
-- [ ] **Memory usage** - Monitor for leaks
-
-### Browser Tests
-- [ ] **Chrome** - Latest version
-- [ ] **Firefox** - Latest version
-- [ ] **Safari** - Latest version
-- [ ] **Mobile browsers** - iOS Safari, Chrome Mobile
-
-## 🆘 Getting Help
-
-### If Migration Fails
-
-1. **Check the logs** - Look for specific error messages
-2. **Revert changes** - Go back to working version
-3. **Check documentation** - Look for migration guides
-4. **Search issues** - Check GitHub issues
-5. **Ask for help** - Create detailed issue report
-
-### Debug Information
-
-When asking for help, include:
-
-```bash
-# Version information
-npm list @jmruthers/pace-core
-node --version
-npm --version
-
-# Build output
-npm run build 2>&1 | tee build.log
-
-# Error details
-# Include full error messages and stack traces
-```
-
-### Emergency Rollback
-
-```bash
-# Rollback to previous version
-npm install @jmruthers/pace-core@0.4.16
-
-# Or specific working version
-npm install @jmruthers/pace-core@0.4.15
-
-# Clear caches
-rm -rf node_modules package-lock.json
-npm install
-```
-
-## 📚 Additional Resources
-
-- **[Complete Migration Guide](./MIGRATION_GUIDE.md)** - Detailed migration instructions
-- **[Migration Overview](./README.md)** - Migration guide index
-- **[Troubleshooting](../troubleshooting/README.md)** - Common issues and solutions
-- **[GitHub Issues](https://github.com/jmruthers/pace-core/issues)** - Report bugs and get help
-
----
-
-**Remember**: Always test migrations in a development environment first!
-
-## ♿ Accessibility
-
-Migration processes should maintain accessibility:
-
-- **Accessibility testing after migration** - Verify all components remain accessible after migration
-- **Screen reader compatibility** - Test with assistive technologies after migration
-- **Keyboard navigation** - Ensure keyboard navigation still works after migration
-
-### Accessibility Best Practices
-
-1. **Test accessibility after migration** - Run accessibility tests after each migration step
-2. **Verify keyboard navigation** - Ensure all interactive elements remain keyboard accessible
-3. **Test with screen readers** - Verify components work with assistive technologies
-
-## ⚠️ Edge Cases
-
-### Migration Failures
-
-When migrations fail:
-- Review error messages carefully
-- Check version compatibility
-- Verify all dependencies are updated
-- Test with minimal configuration
-
-### Partial Migrations
-
-When only partial migration is possible:
-- Document what was migrated and what wasn't
-- Create remediation plan for remaining items
-- Test partially migrated code thoroughly