@jmruthers/pace-core 0.5.186 → 0.5.188

package/docs/best-practices/performance.md

@@ -490,6 +490,17 @@ function VirtualizedEventList() {
 
 ## Network Optimization
 
+### RBAC Performance Optimizations
+
+The RBAC system includes built-in performance optimizations that significantly reduce network requests:
+
+- **Request Deduplication**: Multiple components checking the same permission share network requests
+- **Enhanced Caching**: Two-tier caching (60s short-term + 5min session cache)
+- **Batched Audit Logging**: Audit events are batched to reduce network requests
+- **Memoization**: Components are memoized to prevent unnecessary re-renders
+
+See the [RBAC Performance Guide](../rbac/performance.md) for detailed information.
+
 ### 1. Request Deduplication
 
 ```typescript

package/docs/getting-started/examples/README.md

@@ -460,8 +460,8 @@ npm run dev
 # Build for production
 npm run build
 
-# Preview production build
-npm run preview
+# Preview production build (optional)
+npx vite preview
 ```
 
 #### Features Demonstrated

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

@@ -281,6 +281,8 @@ interface FileDisplayProps {
     record_id={personId}
     organisation_id={organisationId}
     category={FileCategory.IMAGES}
+    folder="images"
+    pageContext="configuration"
     accept="image/*"
     showPreview={true}
   />
@@ -302,6 +304,29 @@ interface FileDisplayProps {
 // without wrapper divs, borders, or metadata. Prefers image files over other types.
 ```
 
+**Document Display (Clickable Links):**
+```tsx
+// Display a PDF or other document as a clickable link
+<FileDisplay
+  supabase={supabase}
+  table_name="medi_action_plan"
+  record_id={planId}
+  organisation_id={organisationId}
+  category={FileCategory.MEDICAL_DOCUMENTS}
+  displayOnly={true}
+  showFallback={true}
+  fallbackText="View Action Plan"
+/>
+// When displayOnly is true and the file is NOT an image (e.g., PDF, Word doc, Excel),
+// renders as a clickable link that opens in a new tab. The link includes:
+// - Document icon (FileText) on the left
+// - Filename in the center
+// - External link icon on the right
+// - Proper security attributes (rel="noopener noreferrer")
+// - Full accessibility support (ARIA labels, keyboard navigation, focus states)
+// If the file URL is unavailable, falls back to the fallback UI.
+```
+
 ## Hooks
 
 ### useFileReference
@@ -459,6 +484,8 @@ await uploadFile({
   organisation_id: 'org-123',
   app_id: 'app-123',
   category: FileCategory.GENERAL_DOCUMENTS,
+  folder: 'documents',
+  pageContext: 'configuration',
   is_public: false
 }, pdfFile);
 
@@ -469,6 +496,8 @@ await uploadFile({
   organisation_id: 'org-123',
   app_id: 'app-123',
   category: FileCategory.PROFILE_PHOTOS,
+  folder: 'profile_photos',
+  pageContext: 'configuration',
   is_public: false
 }, imageFile);
 ```