@jmruthers/pace-core 0.5.101 → 0.5.102

package/docs/api/modules.md

@@ -1,6 +1,6 @@
-[@jmruthers/pace-core - v0.5.101](README.md) / Exports
+[@jmruthers/pace-core - v0.5.102](README.md) / Exports
 
-# @jmruthers/pace-core - v0.5.101
+# @jmruthers/pace-core - v0.5.102
 
 **`File`**
 
@@ -73,7 +73,6 @@ 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)
@@ -224,9 +223,6 @@ import { Dialog, NavigationMenu } from '@jmruthers/pace-core/components';
 - [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)
@@ -448,7 +444,7 @@ ___
 
 #### Defined in
 
-[packages/core/src/hooks/useFileReference.ts:439](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/hooks/useFileReference.ts#L439)
+[packages/core/src/hooks/useFileReference.ts:448](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/hooks/useFileReference.ts#L448)
 
 ___
 
@@ -474,7 +470,7 @@ ___
 
 #### Defined in
 
-[packages/core/src/hooks/useFileReference.ts:445](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/hooks/useFileReference.ts#L445)
+[packages/core/src/hooks/useFileReference.ts:454](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/hooks/useFileReference.ts#L454)
 
 ___
 
@@ -502,7 +498,7 @@ ___
 
 #### Defined in
 
-[packages/core/src/hooks/useFileReference.ts:459](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/hooks/useFileReference.ts#L459)
+[packages/core/src/hooks/useFileReference.ts:468](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/hooks/useFileReference.ts#L468)
 
 ___
 
@@ -1657,8 +1653,7 @@ Component for displaying file references with context-awareness
 This component is context-aware and automatically detects whether it's being used
 in a public or authenticated context. It fetches and displays files from storage.
 
-When `supabase` prop is provided, it uses the explicit client (backwards compatible).
-When `supabase` prop is not provided, it automatically detects context and uses:
+The component automatically detects context and uses:
 - PublicPageProvider context for public pages
 - UnifiedAuthProvider context for authenticated pages
 
@@ -1676,7 +1671,7 @@ React element with file display
 
 #### Defined in
 
-[packages/core/src/components/FileDisplay/FileDisplay.tsx:825](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/FileDisplay/FileDisplay.tsx#L825)
+[packages/core/src/components/FileDisplay/FileDisplay.tsx:726](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/FileDisplay/FileDisplay.tsx#L726)
 
 ___
 
@@ -2601,78 +2596,6 @@ React element with route protection logic
 
 ___
 
-### 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 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
-
-`Element`
-
-React element with event logo or fallback
-
-#### Defined in
-
-[packages/core/src/components/PublicLayout/EventLogo.tsx:399](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/PublicLayout/EventLogo.tsx#L399)
-
-___
-
-### 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:453](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/PublicLayout/EventLogo.tsx#L453)
-
-___
-
-### 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:466](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/PublicLayout/EventLogo.tsx#L466)
-
-___
-
 ### useErrorBoundary
 
 ▸ **useErrorBoundary**(): `Object`
@@ -2915,7 +2838,7 @@ React element with public page header
 
 #### Defined in
 
-[packages/core/src/components/PublicLayout/PublicPageHeader.tsx:89](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/PublicLayout/PublicPageHeader.tsx#L89)
+[packages/core/src/components/PublicLayout/PublicPageHeader.tsx:86](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/PublicLayout/PublicPageHeader.tsx#L86)
 
 ___
 
@@ -4439,7 +4362,16 @@ ___
 
 ▸ **useFilesByCategory**(`supabase`, `table_name`, `record_id`, `category`, `organisation_id`): `Object`
 
-Hook for getting files by category
+Convenience hook for getting files by category with automatic URL loading.
+
+This hook wraps useFileReference().getFilesByCategory and automatically:
+- Loads file references filtered by category
+- Generates URLs for all files (public URLs for public files, signed URLs for private files)
+- Manages state for fileReferences and fileUrls
+- Auto-refetches when table_name, record_id, category, or organisation_id changes
+
+Use this hook when you need files by category with their URLs ready to display.
+For more control, use useFileReference() directly and manage URLs yourself.
 
 #### Parameters
 
@@ -4466,7 +4398,7 @@ Hook for getting files by category
 
 #### Defined in
 
-[packages/core/src/hooks/useFileReference.ts:365](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/hooks/useFileReference.ts#L365)
+[packages/core/src/hooks/useFileReference.ts:374](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/hooks/useFileReference.ts#L374)
 
 ___
 
@@ -6998,6 +6930,7 @@ ___
 ▸ **generateUniqueFileName**(`originalName`): `string`
 
 Generate a unique filename with timestamp and UUID
+Sanitizes the original filename to remove spaces and invalid characters for storage compatibility
 
 #### Parameters
 
@@ -7011,7 +6944,7 @@ Generate a unique filename with timestamp and UUID
 
 #### Defined in
 
-[packages/core/src/utils/storage/helpers.ts:50](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/utils/storage/helpers.ts#L50)
+[packages/core/src/utils/storage/helpers.ts:51](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/utils/storage/helpers.ts#L51)
 
 ___
 
@@ -7035,7 +6968,7 @@ Extract file metadata from a File object
 
 #### Defined in
 
-[packages/core/src/utils/storage/helpers.ts:67](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/utils/storage/helpers.ts#L67)
+[packages/core/src/utils/storage/helpers.ts:78](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/utils/storage/helpers.ts#L78)
 
 ___
 
@@ -7059,7 +6992,7 @@ Upload a file to Supabase storage with app segregation
 
 #### Defined in
 
-[packages/core/src/utils/storage/helpers.ts:141](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/utils/storage/helpers.ts#L141)
+[packages/core/src/utils/storage/helpers.ts:152](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/utils/storage/helpers.ts#L152)
 
 ___
 
@@ -7085,7 +7018,7 @@ Public URL for the file
 
 #### Defined in
 
-[packages/core/src/utils/storage/helpers.ts:213](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/utils/storage/helpers.ts#L213)
+[packages/core/src/utils/storage/helpers.ts:224](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/utils/storage/helpers.ts#L224)
 
 ___
 
@@ -7112,7 +7045,7 @@ Signed URL with expiration timestamp, or null if failed
 
 #### Defined in
 
-[packages/core/src/utils/storage/helpers.ts:309](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/utils/storage/helpers.ts#L309)
+[packages/core/src/utils/storage/helpers.ts:320](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/utils/storage/helpers.ts#L320)
 
 ___
 
@@ -7138,7 +7071,7 @@ Success status and optional error message
 
 #### Defined in
 
-[packages/core/src/utils/storage/helpers.ts:344](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/utils/storage/helpers.ts#L344)
+[packages/core/src/utils/storage/helpers.ts:355](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/utils/storage/helpers.ts#L355)
 
 ___
 
@@ -7163,7 +7096,7 @@ List of files with metadata
 
 #### Defined in
 
-[packages/core/src/utils/storage/helpers.ts:378](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/utils/storage/helpers.ts#L378)
+[packages/core/src/utils/storage/helpers.ts:389](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/utils/storage/helpers.ts#L389)
 
 ___
 
@@ -7189,7 +7122,7 @@ File blob with metadata, or null if failed
 
 #### Defined in
 
-[packages/core/src/utils/storage/helpers.ts:438](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/utils/storage/helpers.ts#L438)
+[packages/core/src/utils/storage/helpers.ts:449](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/utils/storage/helpers.ts#L449)
 
 ___
 
@@ -7216,4 +7149,4 @@ Move a file to archived location (soft delete)
 
 #### Defined in
 
-[packages/core/src/utils/storage/helpers.ts:491](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/utils/storage/helpers.ts#L491)
+[packages/core/src/utils/storage/helpers.ts:502](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/utils/storage/helpers.ts#L502)

package/docs/implementation-guides/file-reference-system.md

@@ -222,7 +222,6 @@ import { FileUpload, FileCategory } from '@jmruthers/pace-core';
 import { FileDisplay, FileCategory } from '@jmruthers/pace-core';
 
 <FileDisplay
-  supabase={supabase}
   table_name="pace_person"
   record_id={personId}
   organisation_id={orgId}
@@ -244,7 +243,6 @@ import { FileDisplay, FileCategory } from '@jmruthers/pace-core';
 ```tsx
 // Display just the first image without category filtering or metadata
 <FileDisplay
-  supabase={supabase}
   table_name="event"
   record_id={eventId}
   organisation_id={orgId}
@@ -252,6 +250,59 @@ import { FileDisplay, FileCategory } from '@jmruthers/pace-core';
 />
 // When displayOnly is true, shows first file (prefers images) in simplified format
 // without wrappers, borders, or metadata. Perfect for clean logo/image displays.
+// FileDisplay automatically detects context (public or authenticated) and uses the appropriate Supabase client.
+```
+
+**With Fallback Display:**
+```tsx
+// Show fallback UI when no file is available or image fails to load
+<FileDisplay
+  table_name="pace_person"
+  record_id={personId}
+  organisation_id={orgId}
+  category={FileCategory.PROFILE_PHOTOS}
+  displayOnly={true}
+  showFallback={true}
+  fallbackSize="lg"
+  generateFallbackText={(fileName) => {
+    // Custom fallback text generator - extracts initials from file name
+    if (!fileName) return 'FL';
+    return fileName.split(/[\s\-_]+/)
+      .map(word => word.charAt(0).toUpperCase())
+      .join('')
+      .substring(0, 3);
+  }}
+/>
+// When showFallback is true, displays a styled fallback box with initials or custom text
+// when no file is found, an error occurs, or an image fails to load.
+// FileDisplay automatically detects context (public or authenticated) and uses the appropriate Supabase client.
+```
+
+**Event Logo Example:**
+
+For displaying event logos, use `FileDisplay` directly with appropriate props:
+
+```tsx
+import { FileDisplay, FileCategory } from '@jmruthers/pace-core';
+
+<FileDisplay
+  table_name="event"
+  record_id={event.id}
+  organisation_id={event.organisation_id}
+  category={FileCategory.EVENT_LOGOS}
+  displayOnly={true}
+  showFallback={true}
+  fallbackSize="lg"
+  generateFallbackText={(fileName) => {
+    // Custom fallback generator from event name
+    if (!event.event_name) return 'EV';
+    return event.event_name
+      .split(/[\s\-_]+/)
+      .map(word => word.charAt(0).toUpperCase())
+      .join('')
+      .substring(0, 3);
+  }}
+/>
 ```
 
 ### React Hooks

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jmruthers/pace-core",
-  "version": "0.5.101",
+  "version": "0.5.102",
   "description": "Clean, modern React component library with Tailwind v4 styling and native utilities",
   "private": false,
   "publishConfig": {

package/src/components/FileDisplay/FileDisplay.test.tsx

@@ -398,7 +398,7 @@ describe('[component] FileDisplay', () => {
       clearError: vi.fn(),
     });
 
-    // This test verifies that displayOnly logic in FileDisplayBackwardsCompat prefers images
+    // This test verifies that displayOnly logic prefers images
     // The component should select the image file over the PDF
     renderWithProviders(<FileDisplay {...baseProps} displayOnly />);