@jmruthers/pace-core 0.6.11 → 0.6.12

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (533) hide show
  1. package/dist/{DataTable-EFYP2QLE.js → DataTable-AQAHSFLM.js} +7 -6
  2. package/dist/{api-BZR2CYXL.js → api-6OQXYT67.js} +2 -1
  3. package/dist/{chunk-L5LFKKLJ.js → chunk-2GBDPPUC.js} +1 -1
  4. package/dist/{chunk-J2KQK6DG.js → chunk-AP5FG7W4.js} +2 -2
  5. package/dist/{chunk-UZNAFKGW.js → chunk-GHCUP64P.js} +1 -21
  6. package/dist/{chunk-V7FTM2LU.js → chunk-H6RTU4DZ.js} +37 -19
  7. package/dist/{chunk-KJXRL3XE.js → chunk-HQTYP6BX.js} +79 -45
  8. package/dist/{chunk-YFTFFJIV.js → chunk-M7QE7XOA.js} +3 -3
  9. package/dist/{chunk-YYTWKVHO.js → chunk-MVVWZ7JV.js} +25 -30
  10. package/dist/{chunk-PCSHBLPB.js → chunk-NJ7FGQWB.js} +5 -5
  11. package/dist/{chunk-WY6Y7KC3.js → chunk-QWIG36BZ.js} +3 -3
  12. package/dist/{chunk-4R3T5ENU.js → chunk-S57OLCLO.js} +9 -6
  13. package/dist/chunk-VFLR5K2H.js +23 -0
  14. package/dist/{chunk-2OEVOGGR.js → chunk-Y2LWSLLB.js} +41 -25
  15. package/dist/{chunk-7A6IMHH2.js → chunk-YFGNMB67.js} +75 -6
  16. package/dist/components.d.ts +3 -3
  17. package/dist/components.js +13 -12
  18. package/dist/{functions-DH45k8ec.d.ts → functions-hF5ImHCr.d.ts} +1 -1
  19. package/dist/hooks.js +8 -7
  20. package/dist/index.d.ts +5 -5
  21. package/dist/index.js +17 -16
  22. package/dist/providers.js +3 -2
  23. package/dist/rbac/index.d.ts +10 -10
  24. package/dist/rbac/index.js +9 -8
  25. package/dist/{types-BE2sEHKd.d.ts → types-Besvoyzb.d.ts} +1 -1
  26. package/dist/{types-CvOPXWWZ.d.ts → types-CGHrxfqc.d.ts} +3 -0
  27. package/dist/types.d.ts +2 -2
  28. package/dist/{usePublicPageContext-B91dGYW1.d.ts → usePublicPageContext-BQrHf95t.d.ts} +1 -1
  29. package/dist/utils.js +4 -3
  30. package/docs/api/@jmruthers/namespaces/DialogPortal/README.md +14 -0
  31. package/docs/api/@jmruthers/namespaces/DialogPortal/variables/displayName.md +11 -0
  32. package/docs/api/README.md +6 -2
  33. package/docs/api/_media/README.md +186 -0
  34. package/docs/api/classes/ColumnFactory.md +225 -0
  35. package/docs/api/classes/Logger.md +246 -0
  36. package/docs/api/classes/RBACAuditManager.md +299 -0
  37. package/docs/api/classes/RBACCache.md +389 -0
  38. package/docs/api/classes/RBACEngine.md +181 -0
  39. package/docs/api/classes/SecureSupabaseClient.md +168 -0
  40. package/docs/api/classes/StorageUtils.md +324 -0
  41. package/docs/api/enumerations/FileCategory.md +137 -0
  42. package/docs/api/enumerations/LogLevel.md +43 -0
  43. package/docs/api/enumerations/RBACErrorCode.md +169 -0
  44. package/docs/api/enumerations/RPCFunction.md +89 -0
  45. package/docs/api/functions/AccessDenied.md +30 -0
  46. package/docs/api/functions/AppSwitcher.md +21 -0
  47. package/docs/api/functions/Badge.md +42 -0
  48. package/docs/api/functions/ContextSelector.md +43 -0
  49. package/docs/api/functions/DataTable.md +36 -0
  50. package/docs/api/functions/DatePickerWithTimezone.md +28 -0
  51. package/docs/api/functions/DialogBody.md +24 -0
  52. package/docs/api/functions/DialogFooter.md +24 -0
  53. package/docs/api/functions/DialogHeader.md +24 -0
  54. package/docs/api/functions/ErrorBoundaryProvider.md +28 -0
  55. package/docs/api/functions/EventServiceProvider.md +28 -0
  56. package/docs/api/functions/FileDisplay.md +25 -0
  57. package/docs/api/functions/FileUpload.md +21 -0
  58. package/docs/api/functions/Form.md +50 -0
  59. package/docs/api/functions/FormField.md +102 -0
  60. package/docs/api/functions/Header.md +21 -0
  61. package/docs/api/functions/InactivityServiceProvider.md +28 -0
  62. package/docs/api/functions/InactivityWarningModal.md +21 -0
  63. package/docs/api/functions/Input.md +49 -0
  64. package/docs/api/functions/NavigationGuard.md +31 -0
  65. package/docs/api/functions/OrganisationServiceProvider.md +28 -0
  66. package/docs/api/functions/PaceAppLayout.md +169 -0
  67. package/docs/api/functions/PasswordChangeForm.md +21 -0
  68. package/docs/api/functions/ProtectedRoute.md +37 -0
  69. package/docs/api/functions/PublicPageFooter.md +21 -0
  70. package/docs/api/functions/PublicPageHeader.md +21 -0
  71. package/docs/api/functions/PublicPageLayout.md +33 -0
  72. package/docs/api/functions/PublicPageProvider.md +30 -0
  73. package/docs/api/functions/Textarea.md +49 -0
  74. package/docs/api/functions/Toaster.md +34 -0
  75. package/docs/api/functions/UnifiedAuthProvider.md +28 -0
  76. package/docs/api/functions/applyPalette.md +33 -0
  77. package/docs/api/functions/archiveFile.md +47 -0
  78. package/docs/api/functions/average.md +63 -0
  79. package/docs/api/functions/buildAppUrl.md +46 -0
  80. package/docs/api/functions/clearInFlightRequests.md +17 -0
  81. package/docs/api/functions/clearPalette.md +18 -0
  82. package/docs/api/functions/clearPublicEventCache.md +18 -0
  83. package/docs/api/functions/clearPublicFileDisplayCache.md +18 -0
  84. package/docs/api/functions/clearPublicLogoCache.md +18 -0
  85. package/docs/api/functions/cn.md +21 -0
  86. package/docs/api/functions/count.md +56 -0
  87. package/docs/api/functions/createAuditManager.md +45 -0
  88. package/docs/api/functions/createBaseClient.md +75 -0
  89. package/docs/api/functions/createLogger.md +95 -0
  90. package/docs/api/functions/createRBACConfig.md +21 -0
  91. package/docs/api/functions/createRBACEngine.md +33 -0
  92. package/docs/api/functions/createRBACExpressMiddleware.md +84 -0
  93. package/docs/api/functions/createRBACMiddleware.md +88 -0
  94. package/docs/api/functions/createSecureClient.md +80 -0
  95. package/docs/api/functions/createSecureDataAccess.md +39 -0
  96. package/docs/api/functions/deleteFile.md +33 -0
  97. package/docs/api/functions/disablePerformanceMonitoring.md +17 -0
  98. package/docs/api/functions/downloadFile.md +33 -0
  99. package/docs/api/functions/emitAuditEvent.md +27 -0
  100. package/docs/api/functions/enablePerformanceMonitoring.md +17 -0
  101. package/docs/api/functions/err.md +23 -0
  102. package/docs/api/functions/exportToCSV.md +56 -0
  103. package/docs/api/functions/exportToCSVWithTableRows.md +46 -0
  104. package/docs/api/functions/extractEventCodeFromPath.md +24 -0
  105. package/docs/api/functions/extractFileMetadata.md +33 -0
  106. package/docs/api/functions/formatCompactNumber.md +27 -0
  107. package/docs/api/functions/formatCurrency.md +31 -0
  108. package/docs/api/functions/formatDate.md +23 -0
  109. package/docs/api/functions/formatDateTime.md +24 -0
  110. package/docs/api/functions/formatFileSize.md +23 -0
  111. package/docs/api/functions/formatInTimeZone.md +46 -0
  112. package/docs/api/functions/formatNumber.md +31 -0
  113. package/docs/api/functions/formatPercent.md +64 -0
  114. package/docs/api/functions/formatTime.md +24 -0
  115. package/docs/api/functions/formatTimeInTimeZone.md +40 -0
  116. package/docs/api/functions/fromSupabaseClient.md +49 -0
  117. package/docs/api/functions/fromZonedTime.md +41 -0
  118. package/docs/api/functions/generateCSVContent.md +55 -0
  119. package/docs/api/functions/generateFilePath.md +29 -0
  120. package/docs/api/functions/generateFileUrlsBatch.md +33 -0
  121. package/docs/api/functions/generatePublicRoutePath.md +27 -0
  122. package/docs/api/functions/generateUniqueFileName.md +24 -0
  123. package/docs/api/functions/getAccessLevel.md +48 -0
  124. package/docs/api/functions/getAllAppPorts.md +19 -0
  125. package/docs/api/functions/getAllStylePaths.md +15 -0
  126. package/docs/api/functions/getAppConfig.md +17 -0
  127. package/docs/api/functions/getAppPort.md +34 -0
  128. package/docs/api/functions/getBucketName.md +27 -0
  129. package/docs/api/functions/getCurrentAppId.md +17 -0
  130. package/docs/api/functions/getCurrentAppName.md +17 -0
  131. package/docs/api/functions/getFileSizeLimit.md +23 -0
  132. package/docs/api/functions/getGlobalAuditManager.md +19 -0
  133. package/docs/api/functions/getInFlightRequestCount.md +19 -0
  134. package/docs/api/functions/getPerformanceMetrics.md +17 -0
  135. package/docs/api/functions/getPerformanceSummary.md +17 -0
  136. package/docs/api/functions/getPermissionMap.md +52 -0
  137. package/docs/api/functions/getPublicEventCacheStats.md +25 -0
  138. package/docs/api/functions/getPublicFileDisplayCacheStats.md +25 -0
  139. package/docs/api/functions/getPublicLogoCacheStats.md +25 -0
  140. package/docs/api/functions/getPublicUrl.md +39 -0
  141. package/docs/api/functions/getRBACConfig.md +15 -0
  142. package/docs/api/functions/getRBACLogger.md +15 -0
  143. package/docs/api/functions/getRoleContext.md +31 -0
  144. package/docs/api/functions/getSignedUrl.md +34 -0
  145. package/docs/api/functions/getStylePath.md +21 -0
  146. package/docs/api/functions/getTimeZoneDifference.md +40 -0
  147. package/docs/api/functions/getTimezoneAbbreviation.md +40 -0
  148. package/docs/api/functions/getUserTimeZone.md +26 -0
  149. package/docs/api/functions/hasAllPermissions.md +41 -0
  150. package/docs/api/functions/hasAnyPermission.md +41 -0
  151. package/docs/api/functions/isDebugMode.md +15 -0
  152. package/docs/api/functions/isDevelopmentMode.md +15 -0
  153. package/docs/api/functions/isErr.md +29 -0
  154. package/docs/api/functions/isOk.md +29 -0
  155. package/docs/api/functions/isPerformanceMonitoringEnabled.md +17 -0
  156. package/docs/api/functions/isPermitted.md +58 -0
  157. package/docs/api/functions/isPermittedCached.md +36 -0
  158. package/docs/api/functions/isRBACInitialized.md +19 -0
  159. package/docs/api/functions/isSecureClient.md +38 -0
  160. package/docs/api/functions/isValidPermission.md +27 -0
  161. package/docs/api/functions/listFiles.md +29 -0
  162. package/docs/api/functions/max.md +63 -0
  163. package/docs/api/functions/min.md +63 -0
  164. package/docs/api/functions/ok.md +29 -0
  165. package/docs/api/functions/parseAndNormalizeEventColours.md +105 -0
  166. package/docs/api/functions/recordAuditEvent.md +23 -0
  167. package/docs/api/functions/recordPermissionCheck.md +31 -0
  168. package/docs/api/functions/resetPerformanceMetrics.md +17 -0
  169. package/docs/api/functions/resolveAppContext.md +27 -0
  170. package/docs/api/functions/roundToNearestMinutes.md +41 -0
  171. package/docs/api/functions/sanitizeFormData.md +49 -0
  172. package/docs/api/functions/sanitizeHtml.md +39 -0
  173. package/docs/api/functions/sanitizeUserInput.md +27 -0
  174. package/docs/api/functions/setAppConfig.md +23 -0
  175. package/docs/api/functions/setGlobalAuditManager.md +25 -0
  176. package/docs/api/functions/setupRBAC.md +31 -0
  177. package/docs/api/functions/sum.md +63 -0
  178. package/docs/api/functions/toZonedTime.md +41 -0
  179. package/docs/api/functions/uploadFile.md +32 -0
  180. package/docs/api/functions/useAccessLevel.md +71 -0
  181. package/docs/api/functions/useAccessibleApps.md +55 -0
  182. package/docs/api/functions/useAppConfig.md +20 -0
  183. package/docs/api/functions/useAuthService.md +15 -0
  184. package/docs/api/functions/useCan.md +99 -0
  185. package/docs/api/functions/useEventService.md +15 -0
  186. package/docs/api/functions/useEventTheme.md +26 -0
  187. package/docs/api/functions/useEvents.md +45 -0
  188. package/docs/api/functions/useFileReference.md +264 -0
  189. package/docs/api/functions/useFileReferenceById.md +63 -0
  190. package/docs/api/functions/useFileReferenceForRecord.md +129 -0
  191. package/docs/api/functions/useFilesByCategory.md +80 -0
  192. package/docs/api/functions/useFormDialog.md +62 -0
  193. package/docs/api/functions/useInactivityService.md +15 -0
  194. package/docs/api/functions/useInactivityTracker.md +21 -0
  195. package/docs/api/functions/useIsPublicPage.md +19 -0
  196. package/docs/api/functions/useMultiplePermissions.md +88 -0
  197. package/docs/api/functions/useOptionalEvents.md +31 -0
  198. package/docs/api/functions/useOrganisationPermissions.md +27 -0
  199. package/docs/api/functions/useOrganisationSecurity.md +15 -0
  200. package/docs/api/functions/useOrganisationService.md +15 -0
  201. package/docs/api/functions/useOrganisations.md +48 -0
  202. package/docs/api/functions/usePermissions.md +130 -0
  203. package/docs/api/functions/usePublicEvent.md +36 -0
  204. package/docs/api/functions/usePublicEventCode.md +32 -0
  205. package/docs/api/functions/usePublicEventLogo.md +48 -0
  206. package/docs/api/functions/usePublicFileDisplay.md +54 -0
  207. package/docs/api/functions/usePublicPageContext.md +19 -0
  208. package/docs/api/functions/usePublicRouteParams.md +31 -0
  209. package/docs/api/functions/useRBAC.md +21 -0
  210. package/docs/api/functions/useResolvedScope.md +46 -0
  211. package/docs/api/functions/useResourcePermissions.md +25 -0
  212. package/docs/api/functions/useRoleManagement.md +121 -0
  213. package/docs/api/functions/useSecureSupabase.md +51 -0
  214. package/docs/api/functions/useSessionRestoration.md +15 -0
  215. package/docs/api/functions/useSessionTracking.md +62 -0
  216. package/docs/api/functions/useToast.md +83 -0
  217. package/docs/api/functions/useUnifiedAuth.md +24 -0
  218. package/docs/api/functions/useZodForm.md +27 -0
  219. package/docs/api/functions/validateFileSize.md +31 -0
  220. package/docs/api/functions/warnIfInsecureClient.md +40 -0
  221. package/docs/api/functions/withAccessLevelGuard.md +67 -0
  222. package/docs/api/functions/withPermissionGuard.md +73 -0
  223. package/docs/api/functions/withRoleGuard.md +86 -0
  224. package/docs/api/globals.md +502 -0
  225. package/docs/api/interfaces/AccessDeniedProps.md +87 -0
  226. package/docs/api/interfaces/AccessibleApp.md +41 -0
  227. package/docs/api/interfaces/AddressFieldProps.md +195 -0
  228. package/docs/api/interfaces/AddressFieldRef.md +67 -0
  229. package/docs/api/interfaces/AggregateConfig.md +35 -0
  230. package/docs/api/interfaces/AppSwitcherProps.md +51 -0
  231. package/docs/api/interfaces/AuthSessionData.md +27 -0
  232. package/docs/api/interfaces/AutocompleteOptions.md +61 -0
  233. package/docs/api/interfaces/AvatarProps.md +97 -0
  234. package/docs/api/interfaces/BadgeProps.md +30 -0
  235. package/docs/api/interfaces/BuildAppUrlOptions.md +41 -0
  236. package/docs/api/interfaces/ButtonProps.md +46 -0
  237. package/docs/api/interfaces/CalendarProps.md +60 -0
  238. package/docs/api/interfaces/CardProps.md +56 -0
  239. package/docs/api/interfaces/ColorPalette.md +13 -0
  240. package/docs/api/interfaces/ColorShade.md +58 -0
  241. package/docs/api/interfaces/ContextSelectorProps.md +131 -0
  242. package/docs/api/interfaces/DataRecord.md +16 -0
  243. package/docs/api/interfaces/DataTableAction.md +198 -0
  244. package/docs/api/interfaces/DataTableColumn.md +422 -0
  245. package/docs/api/interfaces/DataTableProps.md +511 -0
  246. package/docs/api/interfaces/DataTableToolbarButton.md +75 -0
  247. package/docs/api/interfaces/DatePickerWithTimezoneProps.md +75 -0
  248. package/docs/api/interfaces/DialogBodyProps.md +55 -0
  249. package/docs/api/interfaces/DialogCloseProps.md +25 -0
  250. package/docs/api/interfaces/DialogContentProps.md +160 -0
  251. package/docs/api/interfaces/DialogFooterProps.md +25 -0
  252. package/docs/api/interfaces/DialogHeaderProps.md +25 -0
  253. package/docs/api/interfaces/DialogPortalProps.md +19 -0
  254. package/docs/api/interfaces/DialogProps.md +53 -0
  255. package/docs/api/interfaces/DialogTriggerProps.md +53 -0
  256. package/docs/api/interfaces/EmptyStateConfig.md +55 -0
  257. package/docs/api/interfaces/ErrorBoundaryProps.md +131 -0
  258. package/docs/api/interfaces/ErrorBoundaryProviderProps.md +31 -0
  259. package/docs/api/interfaces/ErrorBoundaryState.md +61 -0
  260. package/docs/api/interfaces/EventAppRoleData.md +54 -0
  261. package/docs/api/interfaces/ExportColumn.md +69 -0
  262. package/docs/api/interfaces/ExportOptions.md +109 -0
  263. package/docs/api/interfaces/FileDisplayProps.md +192 -0
  264. package/docs/api/interfaces/FileMetadata.md +97 -0
  265. package/docs/api/interfaces/FileReference.md +89 -0
  266. package/docs/api/interfaces/FileSizeLimits.md +13 -0
  267. package/docs/api/interfaces/FileUploadOptions.md +107 -0
  268. package/docs/api/interfaces/FooterProps.md +37 -0
  269. package/docs/api/interfaces/FormFieldProps.md +171 -0
  270. package/docs/api/interfaces/FormProps.md +93 -0
  271. package/docs/api/interfaces/GrantEventAppRoleParams.md +97 -0
  272. package/docs/api/interfaces/ImportSummary.md +49 -0
  273. package/docs/api/interfaces/InactivityWarningModalProps.md +87 -0
  274. package/docs/api/interfaces/InputProps.md +46 -0
  275. package/docs/api/interfaces/InvalidScopeError.md +37 -0
  276. package/docs/api/interfaces/LabelProps.md +85 -0
  277. package/docs/api/interfaces/LoggerConfig.md +51 -0
  278. package/docs/api/interfaces/LoginFormProps.md +146 -0
  279. package/docs/api/interfaces/MissingUserContextError.md +37 -0
  280. package/docs/api/interfaces/NavigationGuardProps.md +109 -0
  281. package/docs/api/interfaces/NavigationItem.md +91 -0
  282. package/docs/api/interfaces/NavigationMenuProps.md +169 -0
  283. package/docs/api/interfaces/Organisation.md +105 -0
  284. package/docs/api/interfaces/OrganisationContextRequiredError.md +37 -0
  285. package/docs/api/interfaces/OrganisationMembership.md +105 -0
  286. package/docs/api/interfaces/OrganisationSecurityError.md +49 -0
  287. package/docs/api/interfaces/PaceAppLayoutPermissionConfig.md +127 -0
  288. package/docs/api/interfaces/PaceAppLayoutRouteConfigItem.md +91 -0
  289. package/docs/api/interfaces/PaceAppLayoutRoutingConfig.md +79 -0
  290. package/docs/api/interfaces/PaceLoginPageProps.md +41 -0
  291. package/docs/api/interfaces/PagePermissionGuardProps.md +143 -0
  292. package/docs/api/interfaces/PaletteData.md +33 -0
  293. package/docs/api/interfaces/ParsedAddress.md +91 -0
  294. package/docs/api/interfaces/PermissionDeniedError.md +37 -0
  295. package/docs/api/interfaces/ProgressProps.md +35 -0
  296. package/docs/api/interfaces/ProtectedRouteProps.md +67 -0
  297. package/docs/api/interfaces/PublicPageFooterProps.md +97 -0
  298. package/docs/api/interfaces/PublicPageHeaderProps.md +99 -0
  299. package/docs/api/interfaces/PublicPageLayoutProps.md +153 -0
  300. package/docs/api/interfaces/RBACAccessValidateParams.md +41 -0
  301. package/docs/api/interfaces/RBACAccessValidateResult.md +33 -0
  302. package/docs/api/interfaces/RBACAuditLogParams.md +65 -0
  303. package/docs/api/interfaces/RBACAuditLogResult.md +41 -0
  304. package/docs/api/interfaces/RBACContext.md +41 -0
  305. package/docs/api/interfaces/RBACError.md +37 -0
  306. package/docs/api/interfaces/RBACLogger.md +97 -0
  307. package/docs/api/interfaces/RBACNotInitializedError.md +37 -0
  308. package/docs/api/interfaces/RBACPageAccessCheckParams.md +57 -0
  309. package/docs/api/interfaces/RBACPerformanceMetrics.md +109 -0
  310. package/docs/api/interfaces/RBACPermissionCheckParams.md +57 -0
  311. package/docs/api/interfaces/RBACPermissionCheckResult.md +41 -0
  312. package/docs/api/interfaces/RBACPermissionsGetParams.md +49 -0
  313. package/docs/api/interfaces/RBACPermissionsGetResult.md +49 -0
  314. package/docs/api/interfaces/RBACResult.md +47 -0
  315. package/docs/api/interfaces/RBACRoleGrantParams.md +49 -0
  316. package/docs/api/interfaces/RBACRoleGrantResult.md +41 -0
  317. package/docs/api/interfaces/RBACRoleRevokeParams.md +49 -0
  318. package/docs/api/interfaces/RBACRoleRevokeResult.md +41 -0
  319. package/docs/api/interfaces/RBACRoleValidateParams.md +41 -0
  320. package/docs/api/interfaces/RBACRoleValidateResult.md +49 -0
  321. package/docs/api/interfaces/RBACRolesListParams.md +41 -0
  322. package/docs/api/interfaces/RBACRolesListResult.md +57 -0
  323. package/docs/api/interfaces/RBACSessionTrackParams.md +57 -0
  324. package/docs/api/interfaces/RBACSessionTrackResult.md +41 -0
  325. package/docs/api/interfaces/ResourcePermissions.md +119 -0
  326. package/docs/api/interfaces/RevokeEventAppRoleParams.md +81 -0
  327. package/docs/api/interfaces/RoleManagementResult.md +41 -0
  328. package/docs/api/interfaces/SessionRestorationLoaderProps.md +29 -0
  329. package/docs/api/interfaces/StorageConfig.md +33 -0
  330. package/docs/api/interfaces/StorageFileInfo.md +57 -0
  331. package/docs/api/interfaces/StorageFileMetadata.md +113 -0
  332. package/docs/api/interfaces/StorageListOptions.md +79 -0
  333. package/docs/api/interfaces/StorageListResult.md +33 -0
  334. package/docs/api/interfaces/StorageUploadOptions.md +81 -0
  335. package/docs/api/interfaces/StorageUploadResult.md +49 -0
  336. package/docs/api/interfaces/StorageUploadSuccess.md +35 -0
  337. package/docs/api/interfaces/StorageUrlOptions.md +49 -0
  338. package/docs/api/interfaces/StyleImport.md +17 -0
  339. package/docs/api/interfaces/SwitchProps.md +30 -0
  340. package/docs/api/interfaces/TabsContentProps.md +13 -0
  341. package/docs/api/interfaces/TabsListProps.md +13 -0
  342. package/docs/api/interfaces/TabsProps.md +13 -0
  343. package/docs/api/interfaces/TabsTriggerProps.md +41 -0
  344. package/docs/api/interfaces/TextareaProps.md +43 -0
  345. package/docs/api/interfaces/ToastActionElement.md +16 -0
  346. package/docs/api/interfaces/ToastProps.md +13 -0
  347. package/docs/api/interfaces/UnifiedAuthProviderProps.md +129 -0
  348. package/docs/api/interfaces/UseAccessibleAppsReturn.md +55 -0
  349. package/docs/api/interfaces/UseFormDialogOptions.md +49 -0
  350. package/docs/api/interfaces/UseFormDialogReturn.md +95 -0
  351. package/docs/api/interfaces/UseInactivityTrackerOptions.md +103 -0
  352. package/docs/api/interfaces/UseInactivityTrackerReturn.md +91 -0
  353. package/docs/api/interfaces/UsePublicEventLogoOptions.md +69 -0
  354. package/docs/api/interfaces/UsePublicEventLogoReturn.md +66 -0
  355. package/docs/api/interfaces/UsePublicEventOptions.md +29 -0
  356. package/docs/api/interfaces/UsePublicEventReturn.md +56 -0
  357. package/docs/api/interfaces/UsePublicFileDisplayOptions.md +39 -0
  358. package/docs/api/interfaces/UsePublicFileDisplayReturn.md +96 -0
  359. package/docs/api/interfaces/UsePublicRouteParamsReturn.md +76 -0
  360. package/docs/api/interfaces/UseResolvedScopeOptions.md +49 -0
  361. package/docs/api/interfaces/UseResolvedScopeReturn.md +39 -0
  362. package/docs/api/interfaces/UseResourcePermissionsOptions.md +29 -0
  363. package/docs/api/interfaces/UserEventAccess.md +92 -0
  364. package/docs/api/interfaces/UserMenuProps.md +69 -0
  365. package/docs/api/interfaces/UserProfile.md +49 -0
  366. package/docs/api/type-aliases/AccessLevel.md +11 -0
  367. package/docs/api/type-aliases/AccessLevelContext.md +14 -0
  368. package/docs/api/type-aliases/AllPermissions.md +11 -0
  369. package/docs/api/type-aliases/ApiError.md +37 -0
  370. package/docs/api/type-aliases/ApiResult.md +19 -0
  371. package/docs/api/type-aliases/AuditEventType.md +11 -0
  372. package/docs/api/type-aliases/BadgeVariant.md +18 -0
  373. package/docs/api/type-aliases/DataTableFeatureConfig.md +14 -0
  374. package/docs/api/type-aliases/DialogSize.md +13 -0
  375. package/docs/api/type-aliases/EventAppRole.md +11 -0
  376. package/docs/api/type-aliases/FileUploadProps.md +15 -0
  377. package/docs/api/type-aliases/GetRowId.md +33 -0
  378. package/docs/api/type-aliases/GlobalErrorHandler.md +35 -0
  379. package/docs/api/type-aliases/GlobalRole.md +11 -0
  380. package/docs/api/type-aliases/ImportHandlerResult.md +13 -0
  381. package/docs/api/type-aliases/NavigationMode.md +13 -0
  382. package/docs/api/type-aliases/Operation.md +11 -0
  383. package/docs/api/type-aliases/OrganisationContextType.md +13 -0
  384. package/docs/api/type-aliases/OrganisationRole.md +11 -0
  385. package/docs/api/type-aliases/PaceAppLayoutProps.md +14 -0
  386. package/docs/api/type-aliases/Permission.md +11 -0
  387. package/docs/api/type-aliases/PermissionCheck.md +46 -0
  388. package/docs/api/type-aliases/PermissionMap.md +11 -0
  389. package/docs/api/type-aliases/PermissionSource.md +13 -0
  390. package/docs/api/type-aliases/RBACConfig.md +13 -0
  391. package/docs/api/type-aliases/RBACFunctionResponse.md +57 -0
  392. package/docs/api/type-aliases/Scope.md +41 -0
  393. package/docs/api/type-aliases/SessionType.md +11 -0
  394. package/docs/api/type-aliases/UUID.md +11 -0
  395. package/docs/api/type-aliases/UnifiedAuthContextType.md +13 -0
  396. package/docs/api/type-aliases/UseFileReferenceForRecordReturn.md +161 -0
  397. package/docs/api/type-aliases/UseFileReferenceOptions.md +35 -0
  398. package/docs/api/type-aliases/UseFileReferenceReturn.md +13 -0
  399. package/docs/api/variables/ALL_PERMISSIONS.md +281 -0
  400. package/docs/api/variables/APP_PATH_MAPPING.md +14 -0
  401. package/docs/api/variables/AddressField.md +41 -0
  402. package/docs/api/variables/Alert.md +11 -0
  403. package/docs/api/variables/AlertDescription.md +11 -0
  404. package/docs/api/variables/AlertTitle.md +11 -0
  405. package/docs/api/variables/Avatar.md +13 -0
  406. package/docs/api/variables/Button.md +31 -0
  407. package/docs/api/variables/CACHE_PATTERNS.md +89 -0
  408. package/docs/api/variables/Calendar.md +74 -0
  409. package/docs/api/variables/Card.md +11 -0
  410. package/docs/api/variables/CardActions.md +11 -0
  411. package/docs/api/variables/CardContent.md +11 -0
  412. package/docs/api/variables/CardDescription.md +11 -0
  413. package/docs/api/variables/CardFooter.md +11 -0
  414. package/docs/api/variables/CardHeader.md +11 -0
  415. package/docs/api/variables/CardTitle.md +11 -0
  416. package/docs/api/variables/Checkbox.md +11 -0
  417. package/docs/api/variables/DEFAULT_APP_PORT_MAP.md +14 -0
  418. package/docs/api/variables/DEFAULT_FILE_SIZE_LIMIT.md +13 -0
  419. package/docs/api/variables/Dialog.md +14 -0
  420. package/docs/api/variables/DialogClose.md +14 -0
  421. package/docs/api/variables/DialogContent.md +28 -0
  422. package/docs/api/variables/DialogDescription.md +14 -0
  423. package/docs/api/variables/DialogPortal.md +14 -0
  424. package/docs/api/variables/DialogTitle.md +14 -0
  425. package/docs/api/variables/DialogTrigger.md +14 -0
  426. package/docs/api/variables/EVENT_APP_PERMISSIONS.md +109 -0
  427. package/docs/api/variables/ErrorBoundary.md +15 -0
  428. package/docs/api/variables/FILE_SIZE_LIMITS.md +13 -0
  429. package/docs/api/variables/Footer.md +11 -0
  430. package/docs/api/variables/GLOBAL_PERMISSIONS.md +29 -0
  431. package/docs/api/variables/Label.md +34 -0
  432. package/docs/api/variables/LoadingSpinner.md +28 -0
  433. package/docs/api/variables/LoginForm.md +34 -0
  434. package/docs/api/variables/NavigationMenu.md +203 -0
  435. package/docs/api/variables/ORGANISATION_PERMISSIONS.md +89 -0
  436. package/docs/api/variables/PAGE_PERMISSIONS.md +93 -0
  437. package/docs/api/variables/PaceLoginPage.md +40 -0
  438. package/docs/api/variables/PagePermissionGuard.md +11 -0
  439. package/docs/api/variables/Progress.md +32 -0
  440. package/docs/api/variables/SECURE_CLIENT_SYMBOL.md +14 -0
  441. package/docs/api/variables/STORAGE_CONFIG.md +13 -0
  442. package/docs/api/variables/Select.md +26 -0
  443. package/docs/api/variables/SelectContent.md +26 -0
  444. package/docs/api/variables/SelectGroup.md +26 -0
  445. package/docs/api/variables/SelectItem.md +26 -0
  446. package/docs/api/variables/SelectLabel.md +26 -0
  447. package/docs/api/variables/SelectSeparator.md +26 -0
  448. package/docs/api/variables/SelectTrigger.md +26 -0
  449. package/docs/api/variables/SelectValue.md +26 -0
  450. package/docs/api/variables/SessionRestorationLoader.md +11 -0
  451. package/docs/api/variables/Switch.md +23 -0
  452. package/docs/api/variables/Table.md +35 -0
  453. package/docs/api/variables/TableBody.md +11 -0
  454. package/docs/api/variables/TableCaption.md +11 -0
  455. package/docs/api/variables/TableCell.md +11 -0
  456. package/docs/api/variables/TableFooter.md +11 -0
  457. package/docs/api/variables/TableHead.md +11 -0
  458. package/docs/api/variables/TableHeader.md +11 -0
  459. package/docs/api/variables/TableRow.md +11 -0
  460. package/docs/api/variables/Tabs.md +25 -0
  461. package/docs/api/variables/TabsContent.md +24 -0
  462. package/docs/api/variables/TabsList.md +25 -0
  463. package/docs/api/variables/TabsTrigger.md +34 -0
  464. package/docs/api/variables/Toast.md +36 -0
  465. package/docs/api/variables/ToastAction.md +32 -0
  466. package/docs/api/variables/ToastClose.md +32 -0
  467. package/docs/api/variables/ToastDescription.md +32 -0
  468. package/docs/api/variables/ToastProvider.md +11 -0
  469. package/docs/api/variables/ToastTitle.md +32 -0
  470. package/docs/api/variables/ToastViewport.md +26 -0
  471. package/docs/api/variables/Tooltip.md +34 -0
  472. package/docs/api/variables/TooltipContent.md +34 -0
  473. package/docs/api/variables/TooltipProvider.md +11 -0
  474. package/docs/api/variables/TooltipRoot.md +11 -0
  475. package/docs/api/variables/TooltipTrigger.md +11 -0
  476. package/docs/api/variables/UserMenu.md +11 -0
  477. package/docs/api/variables/emailSchema.md +13 -0
  478. package/docs/api/variables/logger.md +203 -0
  479. package/docs/api/variables/nameSchema.md +13 -0
  480. package/docs/api/variables/passwordSchema.md +13 -0
  481. package/docs/api/variables/phoneSchema.md +13 -0
  482. package/docs/api/variables/rbacCache.md +16 -0
  483. package/docs/api/variables/styleConfig.md +25 -0
  484. package/docs/api/variables/urlSchema.md +13 -0
  485. package/docs/api-reference/hooks.md +2 -0
  486. package/docs/implementation-guides/data-tables.md +8 -0
  487. package/docs/rbac/getting-started.md +7 -0
  488. package/docs/rbac/troubleshooting.md +5 -1
  489. package/package.json +3 -3
  490. package/src/components/DataTable/hooks/useDataTableEffectiveActions.ts +29 -19
  491. package/src/components/DataTable/hooks/useDataTableScope.test.ts +5 -13
  492. package/src/components/DataTable/hooks/useDataTableScope.ts +16 -14
  493. package/src/components/Dialog/useDialogLifecycle.test.ts +4 -1
  494. package/src/components/FileDisplay/useFileDisplay.unit.test.ts +12 -8
  495. package/src/components/PaceAppLayout/PaceAppLayout.edge-cases.test.tsx +33 -9
  496. package/src/components/PaceAppLayout/useFilteredNavItems.ts +22 -7
  497. package/src/components/PaceAppLayout/usePaceAppLayoutConfig.ts +44 -23
  498. package/src/components/PaceAppLayout/usePaceAppLayoutPermissions.ts +1 -1
  499. package/src/components/PaceAppLayout/usePaceAppLayoutScope.ts +6 -4
  500. package/src/components/PaceAppLayout/useRoleBasedRouteAccess.ts +2 -2
  501. package/src/hooks/useAppConfig.unit.test.ts +74 -66
  502. package/src/hooks/useComponentPerformance.unit.test.tsx +6 -4
  503. package/src/hooks/useFileUrl.unit.test.ts +1 -3
  504. package/src/hooks/useInactivityTracker.unit.test.ts +6 -2
  505. package/src/hooks/usePerformanceMonitor.unit.test.ts +6 -16
  506. package/src/hooks/usePublicEvent.simple.test.ts +32 -47
  507. package/src/hooks/usePublicEvent.test.ts +9 -15
  508. package/src/providers/services/AuthServiceProvider.test.tsx +10 -5
  509. package/src/providers/services/EventServiceProvider.test.tsx +8 -3
  510. package/src/providers/services/InactivityServiceProvider.test.tsx +8 -3
  511. package/src/providers/services/OrganisationServiceProvider.test.tsx +8 -3
  512. package/src/rbac/README.md +7 -5
  513. package/src/rbac/api.test.ts +113 -56
  514. package/src/rbac/api.ts +80 -10
  515. package/src/rbac/components/NavigationGuard.tsx +2 -1
  516. package/src/rbac/components/PagePermissionGuard.test.tsx +23 -10
  517. package/src/rbac/engine.ts +23 -1
  518. package/src/rbac/hooks/permissions/runPermissionCheck.ts +18 -4
  519. package/src/rbac/hooks/permissions/useCan.test.ts +59 -20
  520. package/src/rbac/hooks/permissions/useCan.ts +7 -3
  521. package/src/rbac/hooks/permissions/useMultiplePermissions.ts +18 -9
  522. package/src/rbac/hooks/useCan.test.ts +2 -3
  523. package/src/rbac/hooks/usePageGuardScope.ts +6 -4
  524. package/src/rbac/hooks/usePagePermissionCheck.ts +4 -4
  525. package/src/rbac/hooks/useResolvedScope.ts +16 -10
  526. package/src/rbac/hooks/useResourcePermissions.test.ts +48 -58
  527. package/src/rbac/hooks/useResourcePermissions.ts +11 -20
  528. package/src/rbac/types.ts +3 -0
  529. package/src/services/AuthService.edge-cases.test.ts +2 -2
  530. package/src/services/EventService.ts +9 -4
  531. package/src/utils/file-reference/file-reference.test.ts +25 -14
  532. package/src/utils/supabase/createBaseClient.test.ts +30 -13
  533. package/docs/api/modules.md +0 -10028
@@ -0,0 +1,13 @@
1
+ [**@jmruthers/pace-core v0.6.12**](../README.md)
2
+
3
+ ***
4
+
5
+ [@jmruthers/pace-core](../globals.md) / FILE\_SIZE\_LIMITS
6
+
7
+ # Variable: FILE\_SIZE\_LIMITS
8
+
9
+ > `const` **FILE\_SIZE\_LIMITS**: [`FileSizeLimits`](../interfaces/FileSizeLimits.md)
10
+
11
+ Defined in: [utils/storage/config.ts:10](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/utils/storage/config.ts#L10)
12
+
13
+ File size limits by MIME type (in bytes)
@@ -0,0 +1,11 @@
1
+ [**@jmruthers/pace-core v0.6.12**](../README.md)
2
+
3
+ ***
4
+
5
+ [@jmruthers/pace-core](../globals.md) / Footer
6
+
7
+ # Variable: Footer
8
+
9
+ > `const` **Footer**: `NamedExoticComponent`\<[`FooterProps`](../interfaces/FooterProps.md)\>
10
+
11
+ Defined in: [components/Footer/Footer.tsx:82](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Footer/Footer.tsx#L82)
@@ -0,0 +1,29 @@
1
+ [**@jmruthers/pace-core v0.6.12**](../README.md)
2
+
3
+ ***
4
+
5
+ [@jmruthers/pace-core](../globals.md) / GLOBAL\_PERMISSIONS
6
+
7
+ # Variable: GLOBAL\_PERMISSIONS
8
+
9
+ > `const` **GLOBAL\_PERMISSIONS**: `object`
10
+
11
+ Defined in: [rbac/permissions.ts:17](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/permissions.ts#L17)
12
+
13
+ ## Type Declaration
14
+
15
+ ### READ\_ALL
16
+
17
+ > `readonly` **READ\_ALL**: `` `read:${string}` `` \| `` `create:${string}` `` \| `` `update:${string}` `` \| `` `delete:${string}` ``
18
+
19
+ ### CREATE\_ALL
20
+
21
+ > `readonly` **CREATE\_ALL**: `` `read:${string}` `` \| `` `create:${string}` `` \| `` `update:${string}` `` \| `` `delete:${string}` ``
22
+
23
+ ### UPDATE\_ALL
24
+
25
+ > `readonly` **UPDATE\_ALL**: `` `read:${string}` `` \| `` `create:${string}` `` \| `` `update:${string}` `` \| `` `delete:${string}` ``
26
+
27
+ ### DELETE\_ALL
28
+
29
+ > `readonly` **DELETE\_ALL**: `` `read:${string}` `` \| `` `create:${string}` `` \| `` `update:${string}` `` \| `` `delete:${string}` ``
@@ -0,0 +1,34 @@
1
+ [**@jmruthers/pace-core v0.6.12**](../README.md)
2
+
3
+ ***
4
+
5
+ [@jmruthers/pace-core](../globals.md) / Label
6
+
7
+ # Variable: Label
8
+
9
+ > `const` **Label**: `ForwardRefExoticComponent`\<[`LabelProps`](../interfaces/LabelProps.md) & `RefAttributes`\<`HTMLLabelElement`\>\>
10
+
11
+ Defined in: [components/Label/Label.tsx:119](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Label/Label.tsx#L119)
12
+
13
+ Label component
14
+ An accessible label with helper text and error state support
15
+
16
+ ## Param
17
+
18
+ Label configuration and styling
19
+
20
+ ## Param
21
+
22
+ Forwarded ref to the label element
23
+
24
+ ## Returns
25
+
26
+ JSX.Element - The rendered label with optional helper text and errors
27
+
28
+ ## Example
29
+
30
+ ```tsx
31
+ <Label htmlFor="email" required helperText="We'll never share your email">
32
+ Email Address
33
+ </Label>
34
+ ```
@@ -0,0 +1,28 @@
1
+ [**@jmruthers/pace-core v0.6.12**](../README.md)
2
+
3
+ ***
4
+
5
+ [@jmruthers/pace-core](../globals.md) / LoadingSpinner
6
+
7
+ # Variable: LoadingSpinner
8
+
9
+ > `const` **LoadingSpinner**: `React.FC`\<`LoadingSpinnerProps`\>
10
+
11
+ Defined in: [components/LoadingSpinner/LoadingSpinner.tsx:83](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/LoadingSpinner/LoadingSpinner.tsx#L83)
12
+
13
+ LoadingSpinner component
14
+ A simple, accessible loading spinner for indicating loading states
15
+
16
+ ## Param
17
+
18
+ Spinner configuration and styling
19
+
20
+ ## Returns
21
+
22
+ JSX.Element - The rendered loading spinner
23
+
24
+ ## Example
25
+
26
+ ```tsx
27
+ <LoadingSpinner size="lg" className="text-main-500" />
28
+ ```
@@ -0,0 +1,34 @@
1
+ [**@jmruthers/pace-core v0.6.12**](../README.md)
2
+
3
+ ***
4
+
5
+ [@jmruthers/pace-core](../globals.md) / LoginForm
6
+
7
+ # Variable: LoginForm
8
+
9
+ > `const` **LoginForm**: `NamedExoticComponent`\<[`LoginFormProps`](../interfaces/LoginFormProps.md)\>
10
+
11
+ Defined in: [components/LoginForm/LoginForm.tsx:154](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/LoginForm/LoginForm.tsx#L154)
12
+
13
+ LoginForm component that provides a ready-to-use authentication form for user sign-in.
14
+ It supports validation, loading state, error handling, and can be customized via props.
15
+ Now includes performance optimizations and onSignUp support.
16
+
17
+ ## Param
18
+
19
+ Login form configuration and handlers
20
+
21
+ ## Returns
22
+
23
+ JSX.Element - The rendered login form
24
+
25
+ ## Example
26
+
27
+ ```tsx
28
+ <LoginForm
29
+ onSignIn={handleSignIn}
30
+ onSuccess={() => navigate('/dashboard')}
31
+ onError={(error) => toast.error(error.message)}
32
+ isLoading={isAuthenticating}
33
+ />
34
+ ```
@@ -0,0 +1,203 @@
1
+ [**@jmruthers/pace-core v0.6.12**](../README.md)
2
+
3
+ ***
4
+
5
+ [@jmruthers/pace-core](../globals.md) / NavigationMenu
6
+
7
+ # Variable: NavigationMenu
8
+
9
+ > `const` **NavigationMenu**: `ForwardRefExoticComponent`\<[`NavigationMenuProps`](../interfaces/NavigationMenuProps.md) & `RefAttributes`\<`HTMLDivElement`\>\>
10
+
11
+ Defined in: [components/NavigationMenu/NavigationMenu.tsx:207](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/NavigationMenu/NavigationMenu.tsx#L207)
12
+
13
+ Unified NavigationMenu component that supports both dropdown and hierarchical navigation modes.
14
+
15
+ A flexible navigation menu component with support for icons, current page highlighting,
16
+ keyboard navigation, and nested menu items.
17
+
18
+ Features:
19
+ - Dropdown mode: Menu button that opens a dropdown list
20
+ - Hierarchical mode: Expandable tree navigation with nested items
21
+ - Icon support for navigation items
22
+ - Current page highlighting
23
+ - Keyboard navigation support (Enter, Space, Escape)
24
+ - Accessible design with proper ARIA attributes
25
+ - Click outside to close (dropdown mode)
26
+ - Recursive rendering for nested items (hierarchical mode)
27
+
28
+ ## Examples
29
+
30
+ Basic dropdown navigation (most common use case):
31
+ ```tsx
32
+ import { NavigationMenu } from '@jmruthers/pace-core';
33
+ import { useNavigate, useLocation } from 'react-router-dom';
34
+
35
+ function AppNavigation() {
36
+ const navigate = useNavigate();
37
+ const location = useLocation();
38
+
39
+ const navItems = [
40
+ { id: 'home', label: 'Home', href: '/', icon: 'Home' },
41
+ { id: 'dashboard', label: 'Dashboard', href: '/dashboard', icon: 'LayoutDashboard' },
42
+ { id: 'reports', label: 'Reports', href: '/reports', icon: 'FileText' },
43
+ { id: 'settings', label: 'Settings', href: '/settings', icon: 'Settings' }
44
+ ];
45
+
46
+ return (
47
+ <NavigationMenu
48
+ items={navItems}
49
+ mode="dropdown"
50
+ currentPath={location.pathname}
51
+ onNavigate={(item) => navigate(item.href)}
52
+ buttonText="Main Menu"
53
+ showIcons={true}
54
+ />
55
+ );
56
+ }
57
+ ```
58
+
59
+ Hierarchical navigation with nested items:
60
+ ```tsx
61
+ import { NavigationMenu } from '@jmruthers/pace-core';
62
+
63
+ function SidebarNavigation() {
64
+ const hierarchicalItems = [
65
+ {
66
+ id: 'user-management',
67
+ label: 'User Management',
68
+ icon: 'Users',
69
+ children: [
70
+ { id: 'users-list', label: 'All Users', href: '/users' },
71
+ { id: 'users-create', label: 'Create User', href: '/users/create' },
72
+ { id: 'user-roles', label: 'User Roles', href: '/users/roles' }
73
+ ]
74
+ },
75
+ {
76
+ id: 'reports',
77
+ label: 'Reports',
78
+ icon: 'BarChart',
79
+ children: [
80
+ { id: 'sales-reports', label: 'Sales Reports', href: '/reports/sales' },
81
+ { id: 'user-reports', label: 'User Reports', href: '/reports/users' }
82
+ ]
83
+ },
84
+ { id: 'settings', label: 'Settings', href: '/settings', icon: 'Settings' }
85
+ ];
86
+
87
+ return (
88
+ <NavigationMenu
89
+ items={hierarchicalItems}
90
+ mode="hierarchical"
91
+ currentPath={window.location.pathname}
92
+ onNavigate={(item) => {
93
+ if (item.href) {
94
+ window.location.href = item.href;
95
+ }
96
+ }}
97
+ className="w-64 bg-sec-50 p-4"
98
+ />
99
+ );
100
+ }
101
+ ```
102
+
103
+ Integration with React Router and authentication:
104
+ ```tsx
105
+ import { NavigationMenu } from '@jmruthers/pace-core';
106
+ import { useNavigate, useLocation } from 'react-router-dom';
107
+ import { useUnifiedAuth } from '@jmruthers/pace-core/providers';
108
+
109
+ function AuthenticatedNavigation() {
110
+ const navigate = useNavigate();
111
+ const location = useLocation();
112
+ const { hasRole, hasPermission } = useUnifiedAuth();
113
+
114
+ // Build navigation items with permission requirements
115
+ const navItems = [
116
+ {
117
+ id: 'dashboard',
118
+ label: 'Dashboard',
119
+ href: '/dashboard',
120
+ icon: 'LayoutDashboard',
121
+ permissions: ['dashboard:read']
122
+ },
123
+ {
124
+ id: 'meals',
125
+ label: 'Meals',
126
+ href: '/meals',
127
+ icon: 'UtensilsCrossed',
128
+ permissions: ['meals:read']
129
+ },
130
+ {
131
+ id: 'admin',
132
+ label: 'Admin Panel',
133
+ href: '/admin',
134
+ icon: 'Shield',
135
+ roles: ['admin', 'super_admin']
136
+ },
137
+ {
138
+ id: 'profile',
139
+ label: 'Profile',
140
+ href: '/profile',
141
+ icon: 'User'
142
+ }
143
+ ];
144
+
145
+ return (
146
+ <NavigationMenu
147
+ items={navItems}
148
+ mode="dropdown"
149
+ currentPath={location.pathname}
150
+ onNavigate={(item) => navigate(item.href)}
151
+ buttonText="Navigation"
152
+ navigationLabel="Main application navigation"
153
+ auditLog={true}
154
+ />
155
+ );
156
+ }
157
+ ```
158
+
159
+ Custom navigation with external links and actions:
160
+ ```tsx
161
+ import { NavigationMenu } from '@jmruthers/pace-core';
162
+ import type { NavigationItem } from '@jmruthers/pace-core';
163
+
164
+ function CustomNavigation() {
165
+ const handleNavigation = (item: NavigationItem) => {
166
+ if (item.id === 'logout') {
167
+ handleLogout();
168
+ } else if (item.href?.startsWith('http')) {
169
+ window.open(item.href, '_blank');
170
+ } else if (item.href) {
171
+ navigate(item.href);
172
+ }
173
+ };
174
+
175
+ const navItems = [
176
+ { id: 'home', label: 'Home', href: '/', icon: 'Home' },
177
+ { id: 'help', label: 'Help Center', href: 'https://help.example.com', icon: 'HelpCircle' },
178
+ { id: 'logout', label: 'Sign Out', icon: 'LogOut' }
179
+ ];
180
+
181
+ return (
182
+ <NavigationMenu
183
+ items={navItems}
184
+ mode="dropdown"
185
+ onNavigate={handleNavigation}
186
+ buttonText="Menu"
187
+ disabled={false}
188
+ />
189
+ );
190
+ }
191
+ ```
192
+
193
+ ## Param
194
+
195
+ NavigationMenu component props including items, mode, navigation handlers, and styling options
196
+
197
+ ## Returns
198
+
199
+ React element with navigation menu functionality
200
+
201
+ ## Since
202
+
203
+ 0.1.0
@@ -0,0 +1,89 @@
1
+ [**@jmruthers/pace-core v0.6.12**](../README.md)
2
+
3
+ ***
4
+
5
+ [@jmruthers/pace-core](../globals.md) / ORGANISATION\_PERMISSIONS
6
+
7
+ # Variable: ORGANISATION\_PERMISSIONS
8
+
9
+ > `const` **ORGANISATION\_PERMISSIONS**: `object`
10
+
11
+ Defined in: [rbac/permissions.ts:28](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/permissions.ts#L28)
12
+
13
+ ## Type Declaration
14
+
15
+ ### READ\_ORGANISATION
16
+
17
+ > `readonly` **READ\_ORGANISATION**: `` `read:${string}` `` \| `` `create:${string}` `` \| `` `update:${string}` `` \| `` `delete:${string}` ``
18
+
19
+ ### UPDATE\_ORGANISATION
20
+
21
+ > `readonly` **UPDATE\_ORGANISATION**: `` `read:${string}` `` \| `` `create:${string}` `` \| `` `update:${string}` `` \| `` `delete:${string}` ``
22
+
23
+ ### DELETE\_ORGANISATION
24
+
25
+ > `readonly` **DELETE\_ORGANISATION**: `` `read:${string}` `` \| `` `create:${string}` `` \| `` `update:${string}` `` \| `` `delete:${string}` ``
26
+
27
+ ### READ\_USERS
28
+
29
+ > `readonly` **READ\_USERS**: `` `read:${string}` `` \| `` `create:${string}` `` \| `` `update:${string}` `` \| `` `delete:${string}` ``
30
+
31
+ ### CREATE\_USERS
32
+
33
+ > `readonly` **CREATE\_USERS**: `` `read:${string}` `` \| `` `create:${string}` `` \| `` `update:${string}` `` \| `` `delete:${string}` ``
34
+
35
+ ### UPDATE\_USERS
36
+
37
+ > `readonly` **UPDATE\_USERS**: `` `read:${string}` `` \| `` `create:${string}` `` \| `` `update:${string}` `` \| `` `delete:${string}` ``
38
+
39
+ ### DELETE\_USERS
40
+
41
+ > `readonly` **DELETE\_USERS**: `` `read:${string}` `` \| `` `create:${string}` `` \| `` `update:${string}` `` \| `` `delete:${string}` ``
42
+
43
+ ### READ\_ROLES
44
+
45
+ > `readonly` **READ\_ROLES**: `` `read:${string}` `` \| `` `create:${string}` `` \| `` `update:${string}` `` \| `` `delete:${string}` ``
46
+
47
+ ### CREATE\_ROLES
48
+
49
+ > `readonly` **CREATE\_ROLES**: `` `read:${string}` `` \| `` `create:${string}` `` \| `` `update:${string}` `` \| `` `delete:${string}` ``
50
+
51
+ ### UPDATE\_ROLES
52
+
53
+ > `readonly` **UPDATE\_ROLES**: `` `read:${string}` `` \| `` `create:${string}` `` \| `` `update:${string}` `` \| `` `delete:${string}` ``
54
+
55
+ ### DELETE\_ROLES
56
+
57
+ > `readonly` **DELETE\_ROLES**: `` `read:${string}` `` \| `` `create:${string}` `` \| `` `update:${string}` `` \| `` `delete:${string}` ``
58
+
59
+ ### READ\_EVENTS
60
+
61
+ > `readonly` **READ\_EVENTS**: `` `read:${string}` `` \| `` `create:${string}` `` \| `` `update:${string}` `` \| `` `delete:${string}` ``
62
+
63
+ ### CREATE\_EVENTS
64
+
65
+ > `readonly` **CREATE\_EVENTS**: `` `read:${string}` `` \| `` `create:${string}` `` \| `` `update:${string}` `` \| `` `delete:${string}` ``
66
+
67
+ ### UPDATE\_EVENTS
68
+
69
+ > `readonly` **UPDATE\_EVENTS**: `` `read:${string}` `` \| `` `create:${string}` `` \| `` `update:${string}` `` \| `` `delete:${string}` ``
70
+
71
+ ### DELETE\_EVENTS
72
+
73
+ > `readonly` **DELETE\_EVENTS**: `` `read:${string}` `` \| `` `create:${string}` `` \| `` `update:${string}` `` \| `` `delete:${string}` ``
74
+
75
+ ### READ\_APPS
76
+
77
+ > `readonly` **READ\_APPS**: `` `read:${string}` `` \| `` `create:${string}` `` \| `` `update:${string}` `` \| `` `delete:${string}` ``
78
+
79
+ ### CREATE\_APPS
80
+
81
+ > `readonly` **CREATE\_APPS**: `` `read:${string}` `` \| `` `create:${string}` `` \| `` `update:${string}` `` \| `` `delete:${string}` ``
82
+
83
+ ### UPDATE\_APPS
84
+
85
+ > `readonly` **UPDATE\_APPS**: `` `read:${string}` `` \| `` `create:${string}` `` \| `` `update:${string}` `` \| `` `delete:${string}` ``
86
+
87
+ ### DELETE\_APPS
88
+
89
+ > `readonly` **DELETE\_APPS**: `` `read:${string}` `` \| `` `create:${string}` `` \| `` `update:${string}` `` \| `` `delete:${string}` ``
@@ -0,0 +1,93 @@
1
+ [**@jmruthers/pace-core v0.6.12**](../README.md)
2
+
3
+ ***
4
+
5
+ [@jmruthers/pace-core](../globals.md) / PAGE\_PERMISSIONS
6
+
7
+ # Variable: PAGE\_PERMISSIONS
8
+
9
+ > `const` **PAGE\_PERMISSIONS**: `object`
10
+
11
+ Defined in: [rbac/permissions.ts:105](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/permissions.ts#L105)
12
+
13
+ ## Type Declaration
14
+
15
+ ### READ\_PAGE
16
+
17
+ > `readonly` **READ\_PAGE**: `` `read:${string}` `` \| `` `create:${string}` `` \| `` `update:${string}` `` \| `` `delete:${string}` ``
18
+
19
+ ### CREATE\_PAGE
20
+
21
+ > `readonly` **CREATE\_PAGE**: `` `read:${string}` `` \| `` `create:${string}` `` \| `` `update:${string}` `` \| `` `delete:${string}` ``
22
+
23
+ ### UPDATE\_PAGE
24
+
25
+ > `readonly` **UPDATE\_PAGE**: `` `read:${string}` `` \| `` `create:${string}` `` \| `` `update:${string}` `` \| `` `delete:${string}` ``
26
+
27
+ ### DELETE\_PAGE
28
+
29
+ > `readonly` **DELETE\_PAGE**: `` `read:${string}` `` \| `` `create:${string}` `` \| `` `update:${string}` `` \| `` `delete:${string}` ``
30
+
31
+ ### READ\_ADMIN
32
+
33
+ > `readonly` **READ\_ADMIN**: `` `read:${string}` `` \| `` `create:${string}` `` \| `` `update:${string}` `` \| `` `delete:${string}` ``
34
+
35
+ ### CREATE\_ADMIN
36
+
37
+ > `readonly` **CREATE\_ADMIN**: `` `read:${string}` `` \| `` `create:${string}` `` \| `` `update:${string}` `` \| `` `delete:${string}` ``
38
+
39
+ ### UPDATE\_ADMIN
40
+
41
+ > `readonly` **UPDATE\_ADMIN**: `` `read:${string}` `` \| `` `create:${string}` `` \| `` `update:${string}` `` \| `` `delete:${string}` ``
42
+
43
+ ### DELETE\_ADMIN
44
+
45
+ > `readonly` **DELETE\_ADMIN**: `` `read:${string}` `` \| `` `create:${string}` `` \| `` `update:${string}` `` \| `` `delete:${string}` ``
46
+
47
+ ### READ\_DASHBOARD
48
+
49
+ > `readonly` **READ\_DASHBOARD**: `` `read:${string}` `` \| `` `create:${string}` `` \| `` `update:${string}` `` \| `` `delete:${string}` ``
50
+
51
+ ### CREATE\_DASHBOARD
52
+
53
+ > `readonly` **CREATE\_DASHBOARD**: `` `read:${string}` `` \| `` `create:${string}` `` \| `` `update:${string}` `` \| `` `delete:${string}` ``
54
+
55
+ ### UPDATE\_DASHBOARD
56
+
57
+ > `readonly` **UPDATE\_DASHBOARD**: `` `read:${string}` `` \| `` `create:${string}` `` \| `` `update:${string}` `` \| `` `delete:${string}` ``
58
+
59
+ ### DELETE\_DASHBOARD
60
+
61
+ > `readonly` **DELETE\_DASHBOARD**: `` `read:${string}` `` \| `` `create:${string}` `` \| `` `update:${string}` `` \| `` `delete:${string}` ``
62
+
63
+ ### READ\_SETTINGS
64
+
65
+ > `readonly` **READ\_SETTINGS**: `` `read:${string}` `` \| `` `create:${string}` `` \| `` `update:${string}` `` \| `` `delete:${string}` ``
66
+
67
+ ### CREATE\_SETTINGS
68
+
69
+ > `readonly` **CREATE\_SETTINGS**: `` `read:${string}` `` \| `` `create:${string}` `` \| `` `update:${string}` `` \| `` `delete:${string}` ``
70
+
71
+ ### UPDATE\_SETTINGS
72
+
73
+ > `readonly` **UPDATE\_SETTINGS**: `` `read:${string}` `` \| `` `create:${string}` `` \| `` `update:${string}` `` \| `` `delete:${string}` ``
74
+
75
+ ### DELETE\_SETTINGS
76
+
77
+ > `readonly` **DELETE\_SETTINGS**: `` `read:${string}` `` \| `` `create:${string}` `` \| `` `update:${string}` `` \| `` `delete:${string}` ``
78
+
79
+ ### READ\_REPORTS
80
+
81
+ > `readonly` **READ\_REPORTS**: `` `read:${string}` `` \| `` `create:${string}` `` \| `` `update:${string}` `` \| `` `delete:${string}` ``
82
+
83
+ ### CREATE\_REPORTS
84
+
85
+ > `readonly` **CREATE\_REPORTS**: `` `read:${string}` `` \| `` `create:${string}` `` \| `` `update:${string}` `` \| `` `delete:${string}` ``
86
+
87
+ ### UPDATE\_REPORTS
88
+
89
+ > `readonly` **UPDATE\_REPORTS**: `` `read:${string}` `` \| `` `create:${string}` `` \| `` `update:${string}` `` \| `` `delete:${string}` ``
90
+
91
+ ### DELETE\_REPORTS
92
+
93
+ > `readonly` **DELETE\_REPORTS**: `` `read:${string}` `` \| `` `create:${string}` `` \| `` `update:${string}` `` \| `` `delete:${string}` ``
@@ -0,0 +1,40 @@
1
+ [**@jmruthers/pace-core v0.6.12**](../README.md)
2
+
3
+ ***
4
+
5
+ [@jmruthers/pace-core](../globals.md) / PaceLoginPage
6
+
7
+ # Variable: PaceLoginPage
8
+
9
+ > `const` **PaceLoginPage**: `React.FC`\<[`PaceLoginPageProps`](../interfaces/PaceLoginPageProps.md)\>
10
+
11
+ Defined in: [components/PaceLoginPage/PaceLoginPage.tsx:169](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/PaceLoginPage/PaceLoginPage.tsx#L169)
12
+
13
+ A consistent, reusable login page for all PACE suite applications.
14
+ It handles the sign-in logic with role-based automatic redirection for admin users,
15
+ enhanced error handling, and dual loading state management.
16
+
17
+ Recent enhancements:
18
+ - Role-based redirection: Admin users are automatically redirected
19
+ - RBAC-based app access control: Checks if user has permission to access the app
20
+ - Enhanced error handling with navigation error recovery
21
+ - Dual loading states: auth loading + form submission loading
22
+ - Error persistence: Auth errors are displayed below the form
23
+ - Navigation safety: Try-catch blocks prevent navigation errors
24
+
25
+ ## Param
26
+
27
+ Login page configuration including app name and redirect path
28
+
29
+ ## Returns
30
+
31
+ JSX.Element - The rendered login page with enhanced functionality
32
+
33
+ ## Example
34
+
35
+ ```tsx
36
+ <PaceLoginPage
37
+ appName="My Application"
38
+ onSuccessRedirectPath="/dashboard"
39
+ />
40
+ ```
@@ -0,0 +1,11 @@
1
+ [**@jmruthers/pace-core v0.6.12**](../README.md)
2
+
3
+ ***
4
+
5
+ [@jmruthers/pace-core](../globals.md) / PagePermissionGuard
6
+
7
+ # Variable: PagePermissionGuard
8
+
9
+ > `const` **PagePermissionGuard**: `MemoExoticComponent`\<(`props`) => `string` \| `number` \| `bigint` \| `boolean` \| `Iterable`\<`ReactNode`, `any`, `any`\> \| `Promise`\<`AwaitedReactNode`\> \| `Element` \| `null`\>
10
+
11
+ Defined in: [rbac/components/PagePermissionGuard.tsx:328](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/components/PagePermissionGuard.tsx#L328)
@@ -0,0 +1,32 @@
1
+ [**@jmruthers/pace-core v0.6.12**](../README.md)
2
+
3
+ ***
4
+
5
+ [@jmruthers/pace-core](../globals.md) / Progress
6
+
7
+ # Variable: Progress
8
+
9
+ > `const` **Progress**: `ForwardRefExoticComponent`\<[`ProgressProps`](../interfaces/ProgressProps.md) & `RefAttributes`\<`HTMLProgressElement`\>\>
10
+
11
+ Defined in: [components/Progress/Progress.tsx:90](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Progress/Progress.tsx#L90)
12
+
13
+ Progress component
14
+ An accessible progress bar with smooth animations using native HTML `<progress>` element
15
+
16
+ ## Param
17
+
18
+ Progress configuration and styling
19
+
20
+ ## Param
21
+
22
+ Forwarded ref to the progress element
23
+
24
+ ## Returns
25
+
26
+ JSX.Element - The rendered progress bar
27
+
28
+ ## Example
29
+
30
+ ```tsx
31
+ <Progress value={75} max={100} />
32
+ ```
@@ -0,0 +1,14 @@
1
+ [**@jmruthers/pace-core v0.6.12**](../README.md)
2
+
3
+ ***
4
+
5
+ [@jmruthers/pace-core](../globals.md) / SECURE\_CLIENT\_SYMBOL
6
+
7
+ # Variable: SECURE\_CLIENT\_SYMBOL
8
+
9
+ > `const` **SECURE\_CLIENT\_SYMBOL**: *typeof* `SECURE_CLIENT_SYMBOL`
10
+
11
+ Defined in: [rbac/utils/clientSecurity.ts:18](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/utils/clientSecurity.ts#L18)
12
+
13
+ Symbol to mark secure clients
14
+ This is attached to clients created by SecureSupabaseClient
@@ -0,0 +1,13 @@
1
+ [**@jmruthers/pace-core v0.6.12**](../README.md)
2
+
3
+ ***
4
+
5
+ [@jmruthers/pace-core](../globals.md) / STORAGE\_CONFIG
6
+
7
+ # Variable: STORAGE\_CONFIG
8
+
9
+ > `const` **STORAGE\_CONFIG**: [`StorageConfig`](../interfaces/StorageConfig.md)
10
+
11
+ Defined in: [utils/storage/config.ts:54](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/utils/storage/config.ts#L54)
12
+
13
+ Storage configuration
@@ -0,0 +1,26 @@
1
+ [**@jmruthers/pace-core v0.6.12**](../README.md)
2
+
3
+ ***
4
+
5
+ [@jmruthers/pace-core](../globals.md) / Select
6
+
7
+ # Variable: Select
8
+
9
+ > `const` **Select**: `ForwardRefExoticComponent`\<`SelectProps` & `UseSelectStateProps` & `RefAttributes`\<`HTMLFieldSetElement`\>\>
10
+
11
+ Defined in: [components/Select/Select.tsx:46](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Select/Select.tsx#L46)
12
+
13
+ Select component root.
14
+ Provides select dropdown functionality with search, keyboard navigation, and accessibility.
15
+
16
+ ## Param
17
+
18
+ Select configuration
19
+
20
+ ## Param
21
+
22
+ Forwarded ref to the fieldset element
23
+
24
+ ## Returns
25
+
26
+ The rendered select component