@jmruthers/pace-core 0.5.93 → 0.5.95

package/docs/api/interfaces/StyleImport.md

@@ -1,4 +1,4 @@
-[@jmruthers/pace-core - v0.5.93](../README.md) / [Exports](../modules.md) / StyleImport
+[@jmruthers/pace-core - v0.5.95](../README.md) / [Exports](../modules.md) / StyleImport
 
 # Interface: StyleImport
 

package/docs/api/interfaces/SwitchProps.md

@@ -1,4 +1,4 @@
-[@jmruthers/pace-core - v0.5.93](../README.md) / [Exports](../modules.md) / SwitchProps
+[@jmruthers/pace-core - v0.5.95](../README.md) / [Exports](../modules.md) / SwitchProps
 
 # Interface: SwitchProps
 

package/docs/api/interfaces/ToastActionElement.md

@@ -1,4 +1,4 @@
-[@jmruthers/pace-core - v0.5.93](../README.md) / [Exports](../modules.md) / ToastActionElement
+[@jmruthers/pace-core - v0.5.95](../README.md) / [Exports](../modules.md) / ToastActionElement
 
 # Interface: ToastActionElement
 

package/docs/api/interfaces/ToastProps.md

@@ -1,4 +1,4 @@
-[@jmruthers/pace-core - v0.5.93](../README.md) / [Exports](../modules.md) / ToastProps
+[@jmruthers/pace-core - v0.5.95](../README.md) / [Exports](../modules.md) / ToastProps
 
 # Interface: ToastProps
 

package/docs/api/interfaces/UnifiedAuthContextType.md

@@ -1,4 +1,4 @@
-[@jmruthers/pace-core - v0.5.93](../README.md) / [Exports](../modules.md) / UnifiedAuthContextType
+[@jmruthers/pace-core - v0.5.95](../README.md) / [Exports](../modules.md) / UnifiedAuthContextType
 
 # Interface: UnifiedAuthContextType
 

package/docs/api/interfaces/UnifiedAuthProviderProps.md

@@ -1,4 +1,4 @@
-[@jmruthers/pace-core - v0.5.93](../README.md) / [Exports](../modules.md) / UnifiedAuthProviderProps
+[@jmruthers/pace-core - v0.5.95](../README.md) / [Exports](../modules.md) / UnifiedAuthProviderProps
 
 # Interface: UnifiedAuthProviderProps
 

package/docs/api/interfaces/UseEventLogoOptions.md

@@ -1,4 +1,4 @@
-[@jmruthers/pace-core - v0.5.93](../README.md) / [Exports](../modules.md) / UseEventLogoOptions
+[@jmruthers/pace-core - v0.5.95](../README.md) / [Exports](../modules.md) / UseEventLogoOptions
 
 # Interface: UseEventLogoOptions
 

package/docs/api/interfaces/UseEventLogoReturn.md

@@ -1,4 +1,4 @@
-[@jmruthers/pace-core - v0.5.93](../README.md) / [Exports](../modules.md) / UseEventLogoReturn
+[@jmruthers/pace-core - v0.5.95](../README.md) / [Exports](../modules.md) / UseEventLogoReturn
 
 # Interface: UseEventLogoReturn
 

package/docs/api/interfaces/UseInactivityTrackerOptions.md

@@ -1,4 +1,4 @@
-[@jmruthers/pace-core - v0.5.93](../README.md) / [Exports](../modules.md) / UseInactivityTrackerOptions
+[@jmruthers/pace-core - v0.5.95](../README.md) / [Exports](../modules.md) / UseInactivityTrackerOptions
 
 # Interface: UseInactivityTrackerOptions
 

package/docs/api/interfaces/UseInactivityTrackerReturn.md

@@ -1,4 +1,4 @@
-[@jmruthers/pace-core - v0.5.93](../README.md) / [Exports](../modules.md) / UseInactivityTrackerReturn
+[@jmruthers/pace-core - v0.5.95](../README.md) / [Exports](../modules.md) / UseInactivityTrackerReturn
 
 # Interface: UseInactivityTrackerReturn
 

package/docs/api/interfaces/UsePublicEventLogoOptions.md

@@ -1,4 +1,4 @@
-[@jmruthers/pace-core - v0.5.93](../README.md) / [Exports](../modules.md) / UsePublicEventLogoOptions
+[@jmruthers/pace-core - v0.5.95](../README.md) / [Exports](../modules.md) / UsePublicEventLogoOptions
 
 # Interface: UsePublicEventLogoOptions
 

package/docs/api/interfaces/UsePublicEventLogoReturn.md

@@ -1,4 +1,4 @@
-[@jmruthers/pace-core - v0.5.93](../README.md) / [Exports](../modules.md) / UsePublicEventLogoReturn
+[@jmruthers/pace-core - v0.5.95](../README.md) / [Exports](../modules.md) / UsePublicEventLogoReturn
 
 # Interface: UsePublicEventLogoReturn
 

package/docs/api/interfaces/UsePublicEventOptions.md

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

package/docs/api/interfaces/UsePublicEventReturn.md

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

package/docs/api/interfaces/UsePublicFileDisplayOptions.md

@@ -0,0 +1,47 @@
+[@jmruthers/pace-core - v0.5.95](../README.md) / [Exports](../modules.md) / UsePublicFileDisplayOptions
+
+# Interface: UsePublicFileDisplayOptions
+
+## Table of contents
+
+### Properties
+
+- [cacheTtl](UsePublicFileDisplayOptions.md#cachettl)
+- [enableCache](UsePublicFileDisplayOptions.md#enablecache)
+- [supabase](UsePublicFileDisplayOptions.md#supabase)
+
+## Properties
+
+### cacheTtl
+
+• `Optional` **cacheTtl**: `number`
+
+Cache TTL in milliseconds (default: 30 minutes)
+
+#### Defined in
+
+[packages/core/src/hooks/public/usePublicFileDisplay.ts:69](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/hooks/public/usePublicFileDisplay.ts#L69)
+
+___
+
+### enableCache
+
+• `Optional` **enableCache**: `boolean`
+
+Whether to enable caching (default: true)
+
+#### Defined in
+
+[packages/core/src/hooks/public/usePublicFileDisplay.ts:71](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/hooks/public/usePublicFileDisplay.ts#L71)
+
+___
+
+### supabase
+
+• **supabase**: `default`\<`Database`, ``"public"``, ``"public"``, `never`, {}\>
+
+Supabase client instance (required)
+
+#### Defined in
+
+[packages/core/src/hooks/public/usePublicFileDisplay.ts:73](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/hooks/public/usePublicFileDisplay.ts#L73)

package/docs/api/interfaces/UsePublicFileDisplayReturn.md

@@ -0,0 +1,120 @@
+[@jmruthers/pace-core - v0.5.95](../README.md) / [Exports](../modules.md) / UsePublicFileDisplayReturn
+
+# Interface: UsePublicFileDisplayReturn
+
+## Table of contents
+
+### Properties
+
+- [fileUrl](UsePublicFileDisplayReturn.md#fileurl)
+- [fileReference](UsePublicFileDisplayReturn.md#filereference)
+- [fileReferences](UsePublicFileDisplayReturn.md#filereferences)
+- [fileUrls](UsePublicFileDisplayReturn.md#fileurls)
+- [fileCount](UsePublicFileDisplayReturn.md#filecount)
+- [isLoading](UsePublicFileDisplayReturn.md#isloading)
+- [error](UsePublicFileDisplayReturn.md#error)
+- [refetch](UsePublicFileDisplayReturn.md#refetch)
+
+## Properties
+
+### fileUrl
+
+• **fileUrl**: ``null`` \| `string`
+
+Single file URL if category is provided and file found, null otherwise
+
+#### Defined in
+
+[packages/core/src/hooks/public/usePublicFileDisplay.ts:50](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/hooks/public/usePublicFileDisplay.ts#L50)
+
+___
+
+### fileReference
+
+• **fileReference**: ``null`` \| [`FileReference`](FileReference.md)
+
+Single file reference if category is provided and file found, null otherwise
+
+#### Defined in
+
+[packages/core/src/hooks/public/usePublicFileDisplay.ts:52](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/hooks/public/usePublicFileDisplay.ts#L52)
+
+___
+
+### fileReferences
+
+• **fileReferences**: [`FileReference`](FileReference.md)[]
+
+Array of all file references for the record (when category not provided or for multiple files)
+
+#### Defined in
+
+[packages/core/src/hooks/public/usePublicFileDisplay.ts:54](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/hooks/public/usePublicFileDisplay.ts#L54)
+
+___
+
+### fileUrls
+
+• **fileUrls**: `Map`\<`string`, `string`\>
+
+Map of file IDs to URLs for multiple files
+
+#### Defined in
+
+[packages/core/src/hooks/public/usePublicFileDisplay.ts:56](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/hooks/public/usePublicFileDisplay.ts#L56)
+
+___
+
+### fileCount
+
+• **fileCount**: `number`
+
+Total count of files for the record
+
+#### Defined in
+
+[packages/core/src/hooks/public/usePublicFileDisplay.ts:58](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/hooks/public/usePublicFileDisplay.ts#L58)
+
+___
+
+### isLoading
+
+• **isLoading**: `boolean`
+
+Whether the data is currently loading
+
+#### Defined in
+
+[packages/core/src/hooks/public/usePublicFileDisplay.ts:60](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/hooks/public/usePublicFileDisplay.ts#L60)
+
+___
+
+### error
+
+• **error**: ``null`` \| `Error`
+
+Any error that occurred during loading
+
+#### Defined in
+
+[packages/core/src/hooks/public/usePublicFileDisplay.ts:62](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/hooks/public/usePublicFileDisplay.ts#L62)
+
+___
+
+### refetch
+
+• **refetch**: () => `Promise`\<`void`\>
+
+Function to manually refetch the data
+
+#### Type declaration
+
+▸ (): `Promise`\<`void`\>
+
+##### Returns
+
+`Promise`\<`void`\>
+
+#### Defined in
+
+[packages/core/src/hooks/public/usePublicFileDisplay.ts:64](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/hooks/public/usePublicFileDisplay.ts#L64)

package/docs/api/interfaces/UsePublicRouteParamsReturn.md

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

package/docs/api/interfaces/UseResolvedScopeOptions.md

@@ -1,4 +1,4 @@
-[@jmruthers/pace-core - v0.5.93](../README.md) / [Exports](../modules.md) / UseResolvedScopeOptions
+[@jmruthers/pace-core - v0.5.95](../README.md) / [Exports](../modules.md) / UseResolvedScopeOptions
 
 # Interface: UseResolvedScopeOptions
 

package/docs/api/interfaces/UseResolvedScopeReturn.md

@@ -1,4 +1,4 @@
-[@jmruthers/pace-core - v0.5.93](../README.md) / [Exports](../modules.md) / UseResolvedScopeReturn
+[@jmruthers/pace-core - v0.5.95](../README.md) / [Exports](../modules.md) / UseResolvedScopeReturn
 
 # Interface: UseResolvedScopeReturn
 

package/docs/api/interfaces/UserEventAccess.md

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

package/docs/api/interfaces/UserMenuProps.md

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

package/docs/api/interfaces/UserProfile.md

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

package/docs/api/modules.md

@@ -1,6 +1,6 @@
-[@jmruthers/pace-core - v0.5.93](README.md) / Exports
+[@jmruthers/pace-core - v0.5.95](README.md) / Exports
 
-# @jmruthers/pace-core - v0.5.93
+# @jmruthers/pace-core - v0.5.95
 
 **`File`**
 
@@ -88,6 +88,8 @@ import { Dialog, NavigationMenu } from '@jmruthers/pace-core/components';
 - [UsePublicEventOptions](interfaces/UsePublicEventOptions.md)
 - [UsePublicEventLogoReturn](interfaces/UsePublicEventLogoReturn.md)
 - [UsePublicEventLogoOptions](interfaces/UsePublicEventLogoOptions.md)
+- [UsePublicFileDisplayReturn](interfaces/UsePublicFileDisplayReturn.md)
+- [UsePublicFileDisplayOptions](interfaces/UsePublicFileDisplayOptions.md)
 - [UsePublicRouteParamsReturn](interfaces/UsePublicRouteParamsReturn.md)
 - [UseEventLogoReturn](interfaces/UseEventLogoReturn.md)
 - [UseEventLogoOptions](interfaces/UseEventLogoOptions.md)
@@ -278,6 +280,9 @@ import { Dialog, NavigationMenu } from '@jmruthers/pace-core/components';
 - [usePublicEventLogo](modules.md#usepubliceventlogo)
 - [clearPublicLogoCache](modules.md#clearpubliclogocache)
 - [getPublicLogoCacheStats](modules.md#getpubliclogocachestats)
+- [usePublicFileDisplay](modules.md#usepublicfiledisplay)
+- [clearPublicFileDisplayCache](modules.md#clearpublicfiledisplaycache)
+- [getPublicFileDisplayCacheStats](modules.md#getpublicfiledisplaycachestats)
 - [usePublicRouteParams](modules.md#usepublicrouteparams)
 - [usePublicEventCode](modules.md#usepubliceventcode)
 - [generatePublicRoutePath](modules.md#generatepublicroutepath)
@@ -1645,21 +1650,33 @@ ___
 
 ### FileDisplay
 
-▸ **FileDisplay**(`«destructured»`): `Element`
+▸ **FileDisplay**(`props`): `Element`
+
+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:
+- PublicPageProvider context for public pages
+- UnifiedAuthProvider context for authenticated pages
 
 #### Parameters
 
-| Name | Type |
-| :------ | :------ |
-| `«destructured»` | [`FileDisplayProps`](interfaces/FileDisplayProps.md) |
+| Name | Type | Description |
+| :------ | :------ | :------ |
+| `props` | [`FileDisplayProps`](interfaces/FileDisplayProps.md) | File display configuration |
 
 #### Returns
 
 `Element`
 
+React element with file display
+
 #### Defined in
 
-[packages/core/src/components/FileDisplay/FileDisplay.tsx:19](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/FileDisplay/FileDisplay.tsx#L19)
+[packages/core/src/components/FileDisplay/FileDisplay.tsx:825](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/FileDisplay/FileDisplay.tsx#L825)
 
 ___
 
@@ -2898,7 +2915,7 @@ React element with public page header
 
 #### Defined in
 
-[packages/core/src/components/PublicLayout/PublicPageHeader.tsx:85](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/PublicLayout/PublicPageHeader.tsx#L85)
+[packages/core/src/components/PublicLayout/PublicPageHeader.tsx:89](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/PublicLayout/PublicPageHeader.tsx#L89)
 
 ___
 
@@ -3040,7 +3057,7 @@ ___
 
 #### Defined in
 
-[packages/core/src/components/Select/Select.tsx:87](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Select/Select.tsx#L87)
+[packages/core/src/components/Select/Select.tsx:167](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Select/Select.tsx#L167)
 
 ___
 
@@ -3060,7 +3077,7 @@ ___
 
 #### Defined in
 
-[packages/core/src/components/Select/Select.tsx:147](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Select/Select.tsx#L147)
+[packages/core/src/components/Select/Select.tsx:342](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Select/Select.tsx#L342)
 
 ___
 
@@ -3080,7 +3097,7 @@ ___
 
 #### Defined in
 
-[packages/core/src/components/Select/Select.tsx:270](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Select/Select.tsx#L270)
+[packages/core/src/components/Select/Select.tsx:465](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Select/Select.tsx#L465)
 
 ___
 
@@ -3100,7 +3117,7 @@ ___
 
 #### Defined in
 
-[packages/core/src/components/Select/Select.tsx:287](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Select/Select.tsx#L287)
+[packages/core/src/components/Select/Select.tsx:482](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Select/Select.tsx#L482)
 
 ___
 
@@ -3120,7 +3137,7 @@ ___
 
 #### Defined in
 
-[packages/core/src/components/Select/Select.tsx:378](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Select/Select.tsx#L378)
+[packages/core/src/components/Select/Select.tsx:585](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Select/Select.tsx#L585)
 
 ___
 
@@ -3140,7 +3157,7 @@ ___
 
 #### Defined in
 
-[packages/core/src/components/Select/Select.tsx:466](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Select/Select.tsx#L466)
+[packages/core/src/components/Select/Select.tsx:686](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Select/Select.tsx#L686)
 
 ___
 
@@ -3160,7 +3177,7 @@ ___
 
 #### Defined in
 
-[packages/core/src/components/Select/Select.tsx:477](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Select/Select.tsx#L477)
+[packages/core/src/components/Select/Select.tsx:697](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Select/Select.tsx#L697)
 
 ___
 
@@ -3180,7 +3197,7 @@ ___
 
 #### Defined in
 
-[packages/core/src/components/Select/Select.tsx:488](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Select/Select.tsx#L488)
+[packages/core/src/components/Select/Select.tsx:708](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Select/Select.tsx#L708)
 
 ___
 
@@ -3931,6 +3948,75 @@ Get cache statistics for debugging
 
 ___
 
+### usePublicFileDisplay
+
+▸ **usePublicFileDisplay**(`table_name`, `record_id`, `organisation_id`, `category`, `options`): [`UsePublicFileDisplayReturn`](interfaces/UsePublicFileDisplayReturn.md)
+
+Hook for accessing public file references
+
+This hook provides access to file references without requiring
+authentication. It only returns public files and generates public URLs.
+
+#### Parameters
+
+| Name | Type | Description |
+| :------ | :------ | :------ |
+| `table_name` | `undefined` \| `string` | The table name containing the file reference |
+| `record_id` | `undefined` \| `string` | The record ID that owns the file(s) |
+| `organisation_id` | `undefined` \| `string` | The organisation ID for storage path |
+| `category` | `undefined` \| [`FileCategory`](enums/FileCategory.md) | Optional file category to filter by (for single file mode) |
+| `options` | [`UsePublicFileDisplayOptions`](interfaces/UsePublicFileDisplayOptions.md) | Configuration options for caching and behavior |
+
+#### Returns
+
+[`UsePublicFileDisplayReturn`](interfaces/UsePublicFileDisplayReturn.md)
+
+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)
+
+___
+
+### clearPublicFileDisplayCache
+
+▸ **clearPublicFileDisplayCache**(): `void`
+
+Clear all cached public file data
+Useful for testing or when you need to force refresh all data
+
+#### Returns
+
+`void`
+
+#### Defined in
+
+[packages/core/src/hooks/public/usePublicFileDisplay.ts:337](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/hooks/public/usePublicFileDisplay.ts#L337)
+
+___
+
+### getPublicFileDisplayCacheStats
+
+▸ **getPublicFileDisplayCacheStats**(): `Object`
+
+Get cache statistics for debugging
+
+#### Returns
+
+`Object`
+
+| Name | Type |
+| :------ | :------ |
+| `size` | `number` |
+| `keys` | `string`[] |
+
+#### Defined in
+
+[packages/core/src/hooks/public/usePublicFileDisplay.ts:348](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/hooks/public/usePublicFileDisplay.ts#L348)
+
+___
+
 ### usePublicRouteParams
 
 ▸ **usePublicRouteParams**(`options?`): [`UsePublicRouteParamsReturn`](interfaces/UsePublicRouteParamsReturn.md)

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

@@ -217,6 +217,7 @@ import { FileUpload, FileCategory } from '@jmruthers/pace-core';
 
 #### FileDisplay Component
 
+**With Category Filter (Single File):**
 ```tsx
 import { FileDisplay, FileCategory } from '@jmruthers/pace-core';
 
@@ -239,6 +240,20 @@ import { FileDisplay, FileCategory } from '@jmruthers/pace-core';
 </FileDisplay>
 ```
 
+**Image-Only Display (Simplified):**
+```tsx
+// Display just the first image without category filtering or metadata
+<FileDisplay
+  supabase={supabase}
+  table_name="event"
+  record_id={eventId}
+  organisation_id={orgId}
+  displayOnly={true}
+/>
+// When displayOnly is true, shows first file (prefers images) in simplified format
+// without wrappers, borders, or metadata. Perfect for clean logo/image displays.
+```
+
 ### React Hooks
 
 #### useFileReference Hook

package/docs/implementation-guides/file-upload-storage.md

@@ -210,6 +210,7 @@ interface FileDisplayProps {
   record_id: string;
   organisation_id: string;
   category?: FileCategory;
+  displayOnly?: boolean;
   showUpload?: boolean;
   showDelete?: boolean;
   className?: string;
@@ -257,6 +258,21 @@ interface FileDisplayProps {
 </FileDisplay>
 ```
 
+**Image-Only Display (Simplified):**
+```tsx
+// Display just the first image file without metadata or wrappers
+<FileDisplay
+  supabase={supabase}
+  table_name="event"
+  record_id={eventId}
+  organisation_id={organisationId}
+  displayOnly={true}
+  className="max-w-xs"
+/>
+// When displayOnly is true and the file is an image, renders a simplified <img> tag
+// without wrapper divs, borders, or metadata. Prefers image files over other types.
+```
+
 ## Hooks
 
 ### useFileReference

package/package.json

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

package/src/components/DataTable/__tests__/DataTableCore.test.tsx

@@ -365,10 +365,11 @@ describe('DataTableCore Component', () => {
         />
       );
 
-      // Check that column headers are rendered by looking for the text content
-      expect(screen.getByText('Name')).toBeInTheDocument();
-      expect(screen.getByText('Age')).toBeInTheDocument();
-      expect(screen.getByText('Email')).toBeInTheDocument();
+      // Check that column headers are rendered by looking for the columnheader role
+      // This avoids matching text in hidden SelectItems (column visibility selector)
+      expect(screen.getByRole('columnheader', { name: 'Name' })).toBeInTheDocument();
+      expect(screen.getByRole('columnheader', { name: 'Age' })).toBeInTheDocument();
+      expect(screen.getByRole('columnheader', { name: 'Email' })).toBeInTheDocument();
     });
 
     it('renders sortable column headers when sorting is enabled', () => {
@@ -386,9 +387,10 @@ describe('DataTableCore Component', () => {
       );
 
       // Check that column headers are rendered and sorting is enabled
-      expect(screen.getByText('Name')).toBeInTheDocument();
-      expect(screen.getByText('Age')).toBeInTheDocument();
-      expect(screen.getByText('Email')).toBeInTheDocument();
+      // Use columnheader role to avoid matching hidden SelectItem labels
+      expect(screen.getByRole('columnheader', { name: /Name/i })).toBeInTheDocument();
+      expect(screen.getByRole('columnheader', { name: /Age/i })).toBeInTheDocument();
+      expect(screen.getByRole('columnheader', { name: /Email/i })).toBeInTheDocument();
     });
   });