@bevel-software/platform-core-frontend 0.4.0 → 0.5.0

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 (326) hide show
  1. package/package.json +5 -3
  2. package/src/core/CoreAppShell.tsx +195 -56
  3. package/src/core/__tests__/AppChrome.test.tsx +125 -0
  4. package/src/core/__tests__/ShellRoutes.test.tsx +130 -95
  5. package/src/core/__tests__/bootstrap.test.ts +63 -0
  6. package/src/core/bootstrap.ts +73 -0
  7. package/src/core/events.ts +12 -0
  8. package/src/core/registry.ts +58 -9
  9. package/src/index.css +100 -11
  10. package/src/index.ts +24 -23
  11. package/src/lib/utils.ts +114 -138
  12. package/src/modules/access/__tests__/ManageAccessDialog.placement.test.tsx +281 -0
  13. package/src/modules/access/__tests__/ManageAccessDialog.test.tsx +166 -1
  14. package/src/modules/access/api.ts +49 -0
  15. package/src/modules/access/components/ManageAccessDialog.tsx +786 -481
  16. package/src/modules/access/hooks/useFileAccess.ts +1 -1
  17. package/src/modules/admin/__tests__/AdminRolesPage.suggest.test.tsx +86 -0
  18. package/src/modules/admin/__tests__/UserAccountsPage.test.tsx +172 -156
  19. package/src/modules/admin/__tests__/admin.unread.test.tsx +61 -0
  20. package/src/modules/admin/components/AdminRolesPage.tsx +44 -38
  21. package/src/modules/admin/components/RolesCorruptedBanner.tsx +11 -10
  22. package/src/modules/admin/components/UserAccountsPage.tsx +361 -353
  23. package/src/modules/admin/state/admin.context.tsx +15 -6
  24. package/src/modules/auth/components/AccountPage.tsx +11 -11
  25. package/src/modules/auth/components/LoginScreen.tsx +12 -12
  26. package/src/modules/auth/services/sso.ts +47 -1
  27. package/src/modules/change-requests/__tests__/ChangeRequestDialog.test.tsx +277 -0
  28. package/src/modules/change-requests/__tests__/author.test.ts +48 -0
  29. package/src/modules/change-requests/__tests__/conflict.test.ts +73 -0
  30. package/src/modules/change-requests/__tests__/diff.test.ts +134 -0
  31. package/src/modules/change-requests/__tests__/propose.test.ts +93 -0
  32. package/src/modules/change-requests/__tests__/useFileOnBranch.test.tsx +72 -0
  33. package/src/modules/change-requests/change-requests.css +22 -0
  34. package/src/modules/change-requests/components/ChangeBox.tsx +277 -0
  35. package/src/modules/change-requests/components/ChangeRequestDialog.tsx +713 -0
  36. package/src/modules/change-requests/components/ConflictHelp.tsx +47 -0
  37. package/src/modules/change-requests/components/CrFileTree.tsx +398 -0
  38. package/src/modules/change-requests/components/FileChangeBoxes.tsx +168 -0
  39. package/src/modules/change-requests/hooks/useApplyChangeRequest.ts +236 -0
  40. package/src/modules/change-requests/hooks/useCrFileDiffs.ts +79 -0
  41. package/src/modules/change-requests/hooks/useFileOnBranch.ts +80 -0
  42. package/src/modules/change-requests/services/change-requests.api.ts +45 -0
  43. package/src/modules/change-requests/services/propose.api.ts +162 -0
  44. package/src/modules/change-requests/utils/author.ts +47 -0
  45. package/src/modules/change-requests/utils/conflict.ts +38 -0
  46. package/src/modules/change-requests/utils/diff.ts +80 -0
  47. package/src/modules/git/__tests__/BranchSwitcher.test.tsx +27 -18
  48. package/src/modules/git/__tests__/FileHistoryPanel.test.tsx +36 -83
  49. package/src/modules/git/__tests__/PullNeededBanner.test.tsx +5 -5
  50. package/src/modules/git/__tests__/PullRequestsForMe.test.tsx +147 -0
  51. package/src/modules/git/__tests__/useAutoPullUpdates.test.tsx +2 -8
  52. package/src/modules/git/components/BranchSwitcher.tsx +68 -31
  53. package/src/modules/git/components/DiffView.tsx +4 -4
  54. package/src/modules/git/components/FileComparisonPanel.tsx +20 -20
  55. package/src/modules/git/components/FileHistoryPanel.tsx +71 -107
  56. package/src/modules/git/components/PullNeededBanner.tsx +6 -13
  57. package/src/modules/git/components/PullRequestsForMe.tsx +71 -36
  58. package/src/modules/git/components/UnifiedDiffView.tsx +4 -4
  59. package/src/modules/git/hooks/__tests__/useGitState.deleteBranch.test.tsx +2 -2
  60. package/src/modules/git/hooks/useGitState.ts +15 -14
  61. package/src/modules/git/services/__tests__/error-messages.test.ts +4 -4
  62. package/src/modules/git/services/error-messages.ts +7 -7
  63. package/src/modules/git/services/git.api.ts +17 -11
  64. package/src/modules/git/services/pr-prompts.ts +2 -2
  65. package/src/modules/git/state/git.context.ts +10 -1
  66. package/src/modules/layout/__tests__/SidebarFrameResponsive.test.tsx +224 -0
  67. package/src/modules/layout/__tests__/SidebarToggle.test.tsx +242 -0
  68. package/src/modules/layout/__tests__/breakpoints.test.ts +56 -0
  69. package/src/modules/layout/breakpoints.ts +6 -0
  70. package/src/modules/layout/components/AppLayout.tsx +17 -5
  71. package/src/modules/layout/components/DemoBanner.tsx +10 -1
  72. package/src/modules/layout/components/MaintenanceOverlay.tsx +104 -104
  73. package/src/modules/layout/components/MobileChatLayout.tsx +31 -26
  74. package/src/modules/layout/components/ResizableThreePaneLayout.tsx +59 -24
  75. package/src/modules/layout/components/SidebarFrame.tsx +317 -0
  76. package/src/modules/layout/components/SidebarToggle.tsx +86 -0
  77. package/src/modules/layout/components/SlideOverlay.tsx +1 -1
  78. package/src/modules/layout/components/__tests__/MobileChatLayout.test.tsx +40 -2
  79. package/src/modules/layout/components/__tests__/ResizableThreePaneLayout.test.tsx +19 -3
  80. package/src/modules/layout/state/sidebar.ts +200 -0
  81. package/src/modules/library/__tests__/AddToGroupDialog.test.tsx +313 -0
  82. package/src/modules/library/__tests__/ChangeRequestDock.test.tsx +84 -0
  83. package/src/modules/library/__tests__/GroupJoinRequests.test.tsx +178 -0
  84. package/src/modules/library/__tests__/GroupPage.test.tsx +479 -0
  85. package/src/modules/library/__tests__/GroupsIndexPage.test.tsx +283 -0
  86. package/src/modules/library/__tests__/GroupsSidebar.contextmenu.test.tsx +175 -0
  87. package/src/modules/library/__tests__/GroupsSidebar.locked.test.tsx +96 -0
  88. package/src/modules/library/__tests__/GroupsSidebar.test.tsx +142 -0
  89. package/src/modules/library/__tests__/GroupsSidebarMenu.test.tsx +142 -0
  90. package/src/modules/library/__tests__/LibraryCard.test.tsx +149 -0
  91. package/src/modules/library/__tests__/LibraryRoutes.test.tsx +378 -0
  92. package/src/modules/library/__tests__/LibrarySidebarMenu.test.tsx +347 -0
  93. package/src/modules/library/__tests__/LockedGroupView.test.tsx +203 -0
  94. package/src/modules/library/__tests__/NewGroupDialog.test.tsx +114 -0
  95. package/src/modules/library/__tests__/PersonalAddDialog.test.tsx +177 -0
  96. package/src/modules/library/__tests__/SkillPage.test.tsx +1063 -0
  97. package/src/modules/library/__tests__/ToolConnectionSection.test.tsx +259 -0
  98. package/src/modules/library/__tests__/ToolLogo.test.tsx +63 -0
  99. package/src/modules/library/__tests__/ToolPage.test.tsx +315 -0
  100. package/src/modules/library/__tests__/ToolSharePanel.test.tsx +36 -0
  101. package/src/modules/library/__tests__/ToolVarRow.test.tsx +260 -0
  102. package/src/modules/library/__tests__/WorkspaceItemRoute.test.tsx +197 -0
  103. package/src/modules/library/__tests__/auth-harness.tsx +37 -0
  104. package/src/modules/library/__tests__/oauth-fragment.test.ts +48 -0
  105. package/src/modules/library/__tests__/status.test.ts +210 -117
  106. package/src/modules/library/__tests__/useSkillDetail.test.tsx +102 -0
  107. package/src/modules/library/__tests__/useToolPage.test.tsx +146 -0
  108. package/src/modules/library/components/AccessRequestsBanner.tsx +101 -0
  109. package/src/modules/library/components/AddToGroupDialog.tsx +115 -0
  110. package/src/modules/library/components/ChangeRequestDock.tsx +71 -47
  111. package/src/modules/library/components/DeleteGroupDialog.tsx +87 -0
  112. package/src/modules/library/components/GroupIndexRow.tsx +63 -0
  113. package/src/modules/library/components/GroupJoinRequests.tsx +56 -0
  114. package/src/modules/library/components/GroupPage.tsx +373 -0
  115. package/src/modules/library/components/GroupsIndexPage.tsx +222 -0
  116. package/src/modules/library/components/GroupsSidebar.tsx +338 -0
  117. package/src/modules/library/components/GroupsSidebarMenu.tsx +160 -0
  118. package/src/modules/library/components/LibraryCard.tsx +153 -132
  119. package/src/modules/library/components/LibraryLayout.tsx +344 -0
  120. package/src/modules/library/components/LibraryPage.tsx +138 -254
  121. package/src/modules/library/components/LockGlyph.tsx +31 -0
  122. package/src/modules/library/components/LockedGroupView.tsx +159 -0
  123. package/src/modules/library/components/ManagedGroupRequests.tsx +70 -0
  124. package/src/modules/library/components/NewGroupDialog.tsx +112 -0
  125. package/src/modules/library/components/NewSkillPanel.tsx +151 -0
  126. package/src/modules/library/components/PageActions.tsx +156 -0
  127. package/src/modules/library/components/PendingSkillReview.tsx +63 -0
  128. package/src/modules/library/components/PersonalAddDialog.tsx +88 -0
  129. package/src/modules/library/components/PersonalGroupPage.tsx +125 -0
  130. package/src/modules/library/components/StatusDot.tsx +25 -0
  131. package/src/modules/library/components/ToolLogo.tsx +171 -0
  132. package/src/modules/library/components/group-page-parts.tsx +419 -0
  133. package/src/modules/library/components/skill-page/SkillFileEditor.tsx +134 -0
  134. package/src/modules/library/components/skill-page/SkillFilePane.tsx +117 -0
  135. package/src/modules/library/components/skill-page/SkillFileTabs.tsx +112 -0
  136. package/src/modules/library/components/skill-page/SkillPage.tsx +673 -0
  137. package/src/modules/library/components/skill-page/tab-ids.ts +33 -0
  138. package/src/modules/library/components/tool-page/ToolConnectionSection.tsx +175 -0
  139. package/src/modules/library/components/tool-page/ToolPage.tsx +228 -0
  140. package/src/modules/library/components/tool-page/ToolSharePanel.tsx +45 -0
  141. package/src/modules/library/components/tool-page/ToolVarRow.tsx +289 -0
  142. package/src/modules/library/hooks/useJoinRequests.ts +114 -0
  143. package/src/modules/library/hooks/useLibraryData.ts +134 -119
  144. package/src/modules/library/hooks/useSkillDetail.ts +119 -74
  145. package/src/modules/library/hooks/useToolPage.ts +145 -0
  146. package/src/modules/library/library.css +108 -320
  147. package/src/modules/library/routes/LibraryRoutes.tsx +134 -0
  148. package/src/modules/library/routes/WorkspaceItemRoute.tsx +74 -0
  149. package/src/modules/library/routes/library-paths.ts +191 -0
  150. package/src/modules/library/services/groups.api.ts +189 -0
  151. package/src/modules/library/services/library.api.ts +291 -164
  152. package/src/modules/library/services/tools.api.ts +60 -0
  153. package/src/modules/library/state/library-context.ts +22 -0
  154. package/src/modules/library/state/library-data.tsx +223 -0
  155. package/src/modules/library/state/toast.context.ts +32 -0
  156. package/src/modules/library/state/toast.tsx +84 -42
  157. package/src/modules/library/utils/clipboard.ts +33 -0
  158. package/src/modules/library/utils/group-summary.ts +68 -0
  159. package/src/modules/library/utils/names.ts +30 -0
  160. package/src/modules/library/utils/navigate-external.ts +15 -0
  161. package/src/modules/library/utils/oauth-fragment.ts +32 -0
  162. package/src/modules/library/utils/personal-group.ts +36 -0
  163. package/src/modules/library/utils/status.ts +199 -116
  164. package/src/modules/library/utils/toast-duration.ts +16 -0
  165. package/src/modules/onboarding/__tests__/onboarding.test.tsx +533 -0
  166. package/src/modules/onboarding/agent-clients.ts +48 -0
  167. package/src/modules/onboarding/components/ConnectAgentPill.tsx +133 -0
  168. package/src/modules/onboarding/components/RootLanding.tsx +54 -0
  169. package/src/modules/onboarding/components/WelcomePage.tsx +364 -0
  170. package/src/modules/onboarding/paths.ts +9 -0
  171. package/src/modules/onboarding/state/onboarding.ts +191 -0
  172. package/src/modules/pr/components/OpenChangeRequestDialog.tsx +10 -10
  173. package/src/modules/pr/services/pr-approvals.api.ts +19 -0
  174. package/src/modules/pr/services/pr-cancel.api.ts +11 -0
  175. package/src/modules/review/components/BinaryChangePlaceholder.tsx +3 -3
  176. package/src/modules/review/components/DiffViewer.tsx +4 -4
  177. package/src/modules/review/components/MarkdownDiffViewer.tsx +84 -26
  178. package/src/modules/review/components/ReviewFileRow.tsx +10 -10
  179. package/src/modules/review/components/ReviewPanel.tsx +49 -17
  180. package/src/modules/review/components/ReviewPanelSurface.tsx +1 -1
  181. package/src/modules/review/components/__tests__/MarkdownDiffViewer.test.tsx +122 -0
  182. package/src/modules/review/hooks/__tests__/useReviewState.test.ts +1 -1
  183. package/src/modules/secrets-vault/components/ConnectToolsPage.tsx +273 -171
  184. package/src/modules/secrets-vault/components/SecretsPage.tsx +313 -276
  185. package/src/modules/secrets-vault/components/ToolSecretsPanel.tsx +109 -92
  186. package/src/modules/secrets-vault/components/__tests__/SecretsPage.test.tsx +82 -51
  187. package/src/modules/secrets-vault/services/connect.api.ts +24 -3
  188. package/src/modules/settings/components/DeploymentPage.tsx +90 -0
  189. package/src/modules/settings/components/SettingsLayout.tsx +135 -0
  190. package/src/modules/settings/components/SettingsNav.tsx +114 -0
  191. package/src/modules/settings/components/__tests__/DeploymentPage.test.tsx +110 -0
  192. package/src/modules/settings/components/__tests__/SettingsLayout.test.tsx +249 -0
  193. package/src/modules/settings/settings-nav-items.tsx +166 -0
  194. package/src/modules/setup/__tests__/setup.test.tsx +540 -0
  195. package/src/modules/setup/components/SetupGate.tsx +67 -0
  196. package/src/modules/setup/components/SetupScreen.tsx +573 -0
  197. package/src/modules/setup/services/setup.api.ts +106 -0
  198. package/src/modules/setup/utils/git-host.ts +34 -0
  199. package/src/modules/toolbar/components/AppSwitcher.tsx +131 -108
  200. package/src/modules/toolbar/components/ExternalAgentAccessPage.tsx +548 -548
  201. package/src/modules/toolbar/components/ProfileMenu.tsx +294 -0
  202. package/src/modules/toolbar/components/Toolbar.tsx +56 -54
  203. package/src/modules/toolbar/components/__tests__/AppSwitcher.test.tsx +176 -122
  204. package/src/modules/toolbar/components/__tests__/Toolbar.test.tsx +252 -77
  205. package/src/modules/tools/ToolsExplorerPage.tsx +45 -40
  206. package/src/modules/workspace/__tests__/design-system-parity.test.ts +133 -0
  207. package/src/modules/workspace/__tests__/testFixtures.ts +2 -0
  208. package/src/modules/workspace/components/EditorTabs.tsx +82 -50
  209. package/src/modules/workspace/components/FileExplorer.tsx +1292 -1068
  210. package/src/modules/workspace/components/FilePaneCard.tsx +53 -0
  211. package/src/modules/workspace/components/FileRoute.tsx +89 -84
  212. package/src/modules/workspace/components/FileViewer.tsx +1312 -906
  213. package/src/modules/workspace/components/KbDocumentShell.tsx +138 -0
  214. package/src/modules/workspace/components/KbFileRail.tsx +128 -0
  215. package/src/modules/workspace/components/KbPageHeader.tsx +390 -0
  216. package/src/modules/workspace/components/__tests__/EditorTabs.test.tsx +87 -3
  217. package/src/modules/workspace/components/__tests__/FileExplorer.test.tsx +293 -39
  218. package/src/modules/workspace/components/__tests__/FileRoute.test.tsx +1 -16
  219. package/src/modules/workspace/components/__tests__/FileViewer.test.tsx +462 -44
  220. package/src/modules/workspace/components/__tests__/KbDocumentShell.test.tsx +84 -0
  221. package/src/modules/workspace/components/__tests__/KbFileRail.test.tsx +83 -0
  222. package/src/modules/workspace/components/__tests__/KbPageHeader.test.tsx +192 -0
  223. package/src/modules/workspace/components/renderers/CopyAnchorButton.tsx +64 -0
  224. package/src/modules/workspace/components/renderers/CsvRenderer.tsx +8 -8
  225. package/src/modules/workspace/components/renderers/DocxRenderer.tsx +18 -9
  226. package/src/modules/workspace/components/renderers/HtmlRenderer.tsx +14 -14
  227. package/src/modules/workspace/components/renderers/ImageRenderer.tsx +2 -2
  228. package/src/modules/workspace/components/renderers/KbMarkdownView.tsx +31 -165
  229. package/src/modules/workspace/components/renderers/MarkdownRenderer.tsx +18 -5
  230. package/src/modules/workspace/components/renderers/MermaidDiagram.tsx +27 -10
  231. package/src/modules/workspace/components/renderers/PdfRenderer.tsx +2 -2
  232. package/src/modules/workspace/components/renderers/TextRenderer.tsx +11 -5
  233. package/src/modules/workspace/components/renderers/ToolForm.tsx +24 -24
  234. package/src/modules/workspace/components/renderers/ToolRenderer.tsx +27 -27
  235. package/src/modules/workspace/components/renderers/XlsxRenderer.tsx +11 -11
  236. package/src/modules/workspace/components/renderers/__tests__/DocxRenderer.test.tsx +66 -0
  237. package/src/modules/workspace/components/renderers/__tests__/KbMarkdownView.test.tsx +17 -1
  238. package/src/modules/workspace/components/renderers/__tests__/MarkdownRenderer.test.tsx +1 -1
  239. package/src/modules/workspace/components/renderers/__tests__/MermaidDiagram.test.tsx +58 -0
  240. package/src/modules/workspace/components/renderers/__tests__/lazyRenderer.test.tsx +68 -0
  241. package/src/modules/workspace/components/renderers/__tests__/rendererLayout.test.ts +64 -0
  242. package/src/modules/workspace/components/renderers/__tests__/sanitizeDocxHtml.test.ts +0 -0
  243. package/src/modules/workspace/components/renderers/chunk-boundary.tsx +71 -0
  244. package/src/modules/workspace/components/renderers/index.ts +78 -2
  245. package/src/modules/workspace/components/renderers/kbMarkdownPipeline.tsx +241 -0
  246. package/src/modules/workspace/components/renderers/lazyRenderer.tsx +59 -0
  247. package/src/modules/workspace/components/renderers/sanitizeDocxHtml.ts +91 -0
  248. package/src/modules/workspace/hooks/__tests__/useLinksOut.test.ts +59 -0
  249. package/src/modules/workspace/hooks/__tests__/useOpenChangeRequests.test.tsx +237 -0
  250. package/src/modules/workspace/hooks/__tests__/useWorkspaceState.test.tsx +185 -0
  251. package/src/modules/workspace/hooks/useAutoGrowTextarea.ts +30 -0
  252. package/src/modules/workspace/hooks/useLastCommit.ts +66 -0
  253. package/src/modules/workspace/hooks/useLinksOut.ts +56 -0
  254. package/src/modules/workspace/hooks/useOpenChangeRequests.ts +20 -0
  255. package/src/modules/workspace/hooks/useWorkspaceState.ts +123 -14
  256. package/src/modules/workspace/routing/__tests__/kb-routes.test.tsx +1 -1
  257. package/src/modules/workspace/services/workspace.api.ts +9 -2
  258. package/src/modules/workspace/state/open-change-requests.context.ts +35 -0
  259. package/src/modules/workspace/state/open-change-requests.tsx +185 -0
  260. package/src/modules/workspace/state/workspace.context.ts +9 -0
  261. package/src/modules/workspace/utils/__tests__/diff.test.ts +87 -0
  262. package/src/modules/workspace/utils/diff.ts +130 -53
  263. package/src/modules/workspace/utils/fileTree.ts +182 -179
  264. package/src/modules/workspace/workspace.css +28 -0
  265. package/src/shared/components/Badge.tsx +62 -0
  266. package/src/shared/components/Banner.tsx +58 -0
  267. package/src/shared/components/Button.tsx +90 -0
  268. package/src/shared/components/Dialog.tsx +6 -6
  269. package/src/shared/components/Field.tsx +45 -0
  270. package/src/shared/components/IconButton.tsx +74 -0
  271. package/src/shared/components/ListRow.tsx +96 -0
  272. package/src/shared/components/Menu.tsx +88 -0
  273. package/src/shared/components/PageShell.tsx +54 -51
  274. package/src/shared/components/Surface.tsx +86 -0
  275. package/src/shared/components/__tests__/primitives.test.tsx +333 -0
  276. package/src/shared/components/index.ts +48 -0
  277. package/src/shared/components/useDismissableMenu.ts +71 -0
  278. package/src/shared/theme/__tests__/accent-contrast.test.ts +84 -0
  279. package/src/shared/theme/index.css +12 -0
  280. package/src/shared/theme/measure.ts +64 -0
  281. package/src/shared/theme/shadows.css +34 -0
  282. package/src/shared/theme/tokens.css +193 -0
  283. package/src/test-setup.ts +9 -0
  284. package/src/modules/access/components/AccessRestrictedBanner.tsx +0 -31
  285. package/src/modules/access/components/NodeOwnersBanner.tsx +0 -30
  286. package/src/modules/git/__tests__/ProtectedBranchBanner.test.tsx +0 -82
  287. package/src/modules/git/components/ProtectedBranchBanner.tsx +0 -42
  288. package/src/modules/library/__tests__/DetailDialog.test.tsx +0 -200
  289. package/src/modules/library/__tests__/diff.test.ts +0 -62
  290. package/src/modules/library/__tests__/loadout.test.tsx +0 -72
  291. package/src/modules/library/components/CompareView.tsx +0 -357
  292. package/src/modules/library/components/DetailDialog.tsx +0 -566
  293. package/src/modules/library/components/GearIcon.tsx +0 -12
  294. package/src/modules/library/components/LoadoutSidebar.tsx +0 -156
  295. package/src/modules/library/components/StatusGem.tsx +0 -21
  296. package/src/modules/library/components/SuggestChange.tsx +0 -171
  297. package/src/modules/library/components/particles.ts +0 -50
  298. package/src/modules/library/state/loadout.tsx +0 -129
  299. package/src/modules/library/utils/diff.ts +0 -102
  300. package/src/modules/pr/__tests__/PrApprovalBadge.test.tsx +0 -93
  301. package/src/modules/pr/__tests__/PrCancelButton.test.tsx +0 -158
  302. package/src/modules/pr/__tests__/PrCancelConfirmDialog.test.tsx +0 -44
  303. package/src/modules/pr/__tests__/PrMergeButton.test.tsx +0 -360
  304. package/src/modules/pr/__tests__/bucketize-comments.test.ts +0 -85
  305. package/src/modules/pr/__tests__/parsePatch.test.ts +0 -104
  306. package/src/modules/pr/__tests__/usePrViewerState.test.ts +0 -72
  307. package/src/modules/pr/components/PrApprovalBadge.tsx +0 -80
  308. package/src/modules/pr/components/PrCancelButton.tsx +0 -99
  309. package/src/modules/pr/components/PrCancelConfirmDialog.tsx +0 -119
  310. package/src/modules/pr/components/PrCommentComposer.tsx +0 -92
  311. package/src/modules/pr/components/PrCommentThread.tsx +0 -168
  312. package/src/modules/pr/components/PrCommentsPanel.tsx +0 -143
  313. package/src/modules/pr/components/PrDiffPane.tsx +0 -425
  314. package/src/modules/pr/components/PrFileRow.tsx +0 -164
  315. package/src/modules/pr/components/PrFilesList.tsx +0 -53
  316. package/src/modules/pr/components/PrHeader.tsx +0 -45
  317. package/src/modules/pr/components/PrHeaderOverflowMenu.tsx +0 -58
  318. package/src/modules/pr/components/PrMergeButton.tsx +0 -268
  319. package/src/modules/pr/components/PrMergeConfirmDialog.tsx +0 -112
  320. package/src/modules/pr/components/PrRefreshFromTargetButton.tsx +0 -110
  321. package/src/modules/pr/components/PrViewer.tsx +0 -364
  322. package/src/modules/pr/hooks/usePrViewerState.ts +0 -150
  323. package/src/modules/pr/state/pr-viewer.context.ts +0 -34
  324. package/src/modules/pr/utils/bucketize-comments.ts +0 -55
  325. package/src/modules/pr/utils/parsePatch.ts +0 -57
  326. package/src/modules/toolbar/components/AdminMenu.tsx +0 -271
@@ -0,0 +1,86 @@
1
+ import type { HTMLAttributes } from 'react';
2
+ import { cn } from '../../lib/utils';
3
+
4
+ /**
5
+ * A raised container. Implements the prototype's `.card`, `.panel`, `.files`,
6
+ * `.crfiles` and `.crmini`.
7
+ *
8
+ * Absorbs 25 confirmed `bg-white + border + rounded` blocks and is the funnel
9
+ * for the app's 92-site `bg-white` split — a `bg-white` is either the page
10
+ * canvas or a raised surface, and the two want different colours the moment
11
+ * the palette stops being pure white.
12
+ *
13
+ * `interactive` adds the hover/press affordance the prototype gives clickable
14
+ * cards. It does NOT make the element a button: pass `as="button"` for that,
15
+ * so the semantics and the styling are decided independently.
16
+ */
17
+
18
+ export type SurfaceTone = 'surface' | 'sunken' | 'sidebar';
19
+ export type SurfaceRadius = 'md' | 'lg' | 'xl' | '2xl';
20
+ export type SurfaceElevation = 'none' | 'card' | 'overlay';
21
+
22
+ const TONE: Record<SurfaceTone, string> = {
23
+ surface: 'bg-surface',
24
+ sunken: 'bg-sunken',
25
+ sidebar: 'bg-sidebar',
26
+ };
27
+
28
+ const RADIUS: Record<SurfaceRadius, string> = {
29
+ md: 'rounded-md',
30
+ lg: 'rounded-lg',
31
+ xl: 'rounded-xl',
32
+ '2xl': 'rounded-2xl',
33
+ };
34
+
35
+ const ELEVATION: Record<SurfaceElevation, string> = {
36
+ none: '',
37
+ card: 'shadow-card',
38
+ overlay: 'shadow-overlay',
39
+ };
40
+
41
+ export interface SurfaceProps extends HTMLAttributes<HTMLElement> {
42
+ as?: 'div' | 'section' | 'aside' | 'article' | 'button';
43
+ /**
44
+ * Only meaningful with `as="button"`. Declared here because a `<button>`
45
+ * inside a form defaults to `type="submit"`, so a card that omits it would
46
+ * submit the form it happens to sit in.
47
+ */
48
+ type?: 'button' | 'submit' | 'reset';
49
+ tone?: SurfaceTone;
50
+ radius?: SurfaceRadius;
51
+ elevation?: SurfaceElevation;
52
+ /** Adds the prototype's hover border/background lift and press scale. */
53
+ interactive?: boolean;
54
+ /** Applies the card's default 14px/16px padding. */
55
+ padded?: boolean;
56
+ }
57
+
58
+ export function Surface({
59
+ as: Tag = 'div',
60
+ tone = 'surface',
61
+ radius = 'xl',
62
+ elevation = 'card',
63
+ interactive = false,
64
+ padded = false,
65
+ className,
66
+ children,
67
+ ...rest
68
+ }: SurfaceProps) {
69
+ return (
70
+ <Tag
71
+ className={cn(
72
+ 'border border-line',
73
+ TONE[tone],
74
+ RADIUS[radius],
75
+ ELEVATION[elevation],
76
+ padded && 'px-4 pt-3.5 pb-3',
77
+ interactive &&
78
+ 'cursor-pointer transition-[border-color,background-color,transform] hover:border-line-strong hover:bg-surface-hover active:scale-[.995]',
79
+ className,
80
+ )}
81
+ {...rest}
82
+ >
83
+ {children}
84
+ </Tag>
85
+ );
86
+ }
@@ -0,0 +1,333 @@
1
+ import { describe, it, expect, vi } from 'vitest';
2
+ import { render, screen } from '@testing-library/react';
3
+ import userEvent from '@testing-library/user-event';
4
+ import type { ReactElement } from 'react';
5
+ import { cn } from '../../../lib/utils';
6
+ import {
7
+ Button,
8
+ buttonClasses,
9
+ IconButton,
10
+ Surface,
11
+ ListRow,
12
+ Badge,
13
+ Banner,
14
+ TextField,
15
+ TextAreaField,
16
+ MenuPanel,
17
+ MenuItem,
18
+ MenuLabel,
19
+ } from '../index';
20
+
21
+ /**
22
+ * The a11y layer is a FROZEN API: 76 existing tests select components by
23
+ * `role`, `aria-label` and `title`. Measured against this suite, dropping
24
+ * `title=` breaks 31 tests, `role=` breaks 29 and `aria-label` breaks 16.
25
+ *
26
+ * So the contract every primitive must honour is: spread `...rest` onto the
27
+ * root node, and never synthesise or override those three attributes. The
28
+ * table below asserts that for every primitive at once — if someone adds a
29
+ * primitive that swallows `title`, this fails rather than a screen-reader
30
+ * regression shipping silently.
31
+ */
32
+ const A11Y_CASES: Array<[string, (props: Record<string, unknown>) => ReactElement]> = [
33
+ ['Button', (p) => <Button {...p}>x</Button>],
34
+ ['IconButton', (p) => <IconButton aria-label="fallback" {...p} />],
35
+ ['Surface', (p) => <Surface {...p}>x</Surface>],
36
+ ['ListRow', (p) => <ListRow {...p} label="x" />],
37
+ ['Badge', (p) => <Badge {...p}>x</Badge>],
38
+ ['Banner', (p) => <Banner role="status" {...p}>x</Banner>],
39
+ ['TextField', (p) => <TextField {...p} />],
40
+ ['TextAreaField', (p) => <TextAreaField {...p} />],
41
+ ['MenuPanel', (p) => <MenuPanel {...p}>x</MenuPanel>],
42
+ ['MenuItem', (p) => <MenuItem {...p}>x</MenuItem>],
43
+ ['MenuLabel', (p) => <MenuLabel {...p}>x</MenuLabel>],
44
+ ];
45
+
46
+ describe('cn() knows the design system scales', () => {
47
+ it('does not drop a semantic text colour when a custom size follows it', () => {
48
+ // Regression: `text-ui` is a FONT SIZE. Untaught, tailwind-merge reads it
49
+ // as a text colour, judges it to conflict with `text-ink-muted`, and drops
50
+ // the colour — silently, in every primitive that composes size + colour.
51
+ expect(cn('text-ink-muted', 'text-ui')).toBe('text-ink-muted text-ui');
52
+ expect(cn('text-danger', 'text-meta')).toBe('text-danger text-meta');
53
+ });
54
+
55
+ it('still collapses genuine conflicts within one namespace', () => {
56
+ expect(cn('text-ink', 'text-danger')).toBe('text-danger');
57
+ expect(cn('text-ui', 'text-body')).toBe('text-body');
58
+ expect(cn('shadow-card', 'shadow-overlay')).toBe('shadow-overlay');
59
+ });
60
+
61
+ it('lets a caller override a primitive default via className', () => {
62
+ expect(cn('bg-surface', 'bg-sunken')).toBe('bg-sunken');
63
+ });
64
+ });
65
+
66
+ describe('a11y contract (C4): every primitive forwards role/aria-label/title', () => {
67
+ it.each(A11Y_CASES)('%s forwards all three untouched', (_name, renderFn) => {
68
+ const { container } = render(
69
+ renderFn({
70
+ 'data-probe': 'root',
71
+ role: 'note',
72
+ 'aria-label': 'my-label',
73
+ title: 'my-tooltip',
74
+ }),
75
+ );
76
+ const root = container.querySelector('[data-probe="root"]');
77
+ expect(root).not.toBeNull();
78
+ expect(root!.getAttribute('role')).toBe('note');
79
+ expect(root!.getAttribute('aria-label')).toBe('my-label');
80
+ expect(root!.getAttribute('title')).toBe('my-tooltip');
81
+ });
82
+
83
+ it('ListRow does NOT shadow the native title attribute with its text prop', () => {
84
+ // Regression: `label` used to be called `title`, which collided with the
85
+ // HTML attribute and would have broken the 31 tests that read it.
86
+ render(<ListRow data-testid="row" label="Row text" title="Tooltip text" />);
87
+ const row = screen.getByTestId('row');
88
+ expect(row.getAttribute('title')).toBe('Tooltip text');
89
+ expect(row).toHaveTextContent('Row text');
90
+ });
91
+ });
92
+
93
+ describe('Button', () => {
94
+ it('defaults to type="button" so it never submits a form by accident', () => {
95
+ render(<Button>Save</Button>);
96
+ expect(screen.getByRole('button', { name: 'Save' })).toHaveAttribute('type', 'button');
97
+ });
98
+
99
+ it('honours an explicit type', () => {
100
+ render(<Button type="submit">Go</Button>);
101
+ expect(screen.getByRole('button', { name: 'Go' })).toHaveAttribute('type', 'submit');
102
+ });
103
+
104
+ it('fires onClick when enabled and not when disabled', async () => {
105
+ const user = userEvent.setup();
106
+ const onClick = vi.fn();
107
+ const { rerender } = render(<Button onClick={onClick}>Go</Button>);
108
+ await user.click(screen.getByRole('button'));
109
+ expect(onClick).toHaveBeenCalledTimes(1);
110
+
111
+ rerender(
112
+ <Button onClick={onClick} disabled>
113
+ Go
114
+ </Button>,
115
+ );
116
+ await user.click(screen.getByRole('button'));
117
+ expect(onClick).toHaveBeenCalledTimes(1);
118
+ });
119
+
120
+ it('applies one disabled treatment rather than per-call-site copies', () => {
121
+ render(<Button disabled>Go</Button>);
122
+ const cls = screen.getByRole('button').className;
123
+ expect(cls).toContain('disabled:opacity-50');
124
+ expect(cls).toContain('disabled:cursor-not-allowed');
125
+ });
126
+
127
+ it('renders leading and trailing icons around the label', () => {
128
+ render(
129
+ <Button leadingIcon={<span>L</span>} trailingIcon={<span>T</span>}>
130
+ Mid
131
+ </Button>,
132
+ );
133
+ expect(screen.getByRole('button').textContent).toBe('LMidT');
134
+ });
135
+
136
+ it('buttonClasses produces the same classes as the component, for <a>/<Link>', () => {
137
+ render(<Button variant="primary" size="sm">x</Button>);
138
+ expect(screen.getByRole('button').className).toBe(
139
+ buttonClasses({ variant: 'primary', size: 'sm' }),
140
+ );
141
+ });
142
+
143
+ it.each([
144
+ ['primary', 'bg-accent'],
145
+ ['outline', 'border-line-strong'],
146
+ ['quiet', 'text-ink-muted'],
147
+ ['danger', 'text-danger'],
148
+ ] as const)('variant %s resolves through a token, not a raw colour', (variant, expected) => {
149
+ render(<Button variant={variant}>x</Button>);
150
+ expect(screen.getByRole('button').className).toContain(expected);
151
+ });
152
+ });
153
+
154
+ describe('IconButton', () => {
155
+ it('is reachable by its required accessible name', () => {
156
+ render(<IconButton aria-label="Hide sidebar">x</IconButton>);
157
+ expect(screen.getByRole('button', { name: 'Hide sidebar' })).toBeInTheDocument();
158
+ });
159
+
160
+ it('shows a pressed background when active', () => {
161
+ // Match a STANDALONE class: `hover:bg-hover` is always present and
162
+ // contains `bg-hover` as a substring, so a naive contains() never fails.
163
+ const hasBare = (el: Element) => el.className.split(/\s+/).includes('bg-hover');
164
+ const { rerender } = render(<IconButton aria-label="Menu" />);
165
+ expect(hasBare(screen.getByRole('button'))).toBe(false);
166
+ rerender(<IconButton aria-label="Menu" active />);
167
+ expect(hasBare(screen.getByRole('button'))).toBe(true);
168
+ });
169
+
170
+ it.each([28, 24, 22, 18] as const)('size %s maps to a fixed square', (size) => {
171
+ const { container } = render(<IconButton aria-label="x" size={size} />);
172
+ const cls = container.querySelector('button')!.className;
173
+ expect(cls).toMatch(/h-(7|6|\[22px\]|\[18px\])/);
174
+ });
175
+ });
176
+
177
+ describe('Surface', () => {
178
+ it('renders the requested element', () => {
179
+ const { container } = render(<Surface as="section">x</Surface>);
180
+ expect(container.querySelector('section')).not.toBeNull();
181
+ });
182
+
183
+ it('only adds hover/press affordances when interactive', () => {
184
+ const { container, rerender } = render(<Surface>x</Surface>);
185
+ expect(container.firstElementChild!.className).not.toContain('cursor-pointer');
186
+ rerender(<Surface interactive>x</Surface>);
187
+ expect(container.firstElementChild!.className).toContain('cursor-pointer');
188
+ });
189
+
190
+ it('elevation none emits no shadow class', () => {
191
+ const { container } = render(<Surface elevation="none">x</Surface>);
192
+ expect(container.firstElementChild!.className).not.toMatch(/shadow-/);
193
+ });
194
+ });
195
+
196
+ describe('ListRow', () => {
197
+ it('as="button" gets type="button" so it never submits', () => {
198
+ render(<ListRow as="button" label="Row" />);
199
+ expect(screen.getByRole('button')).toHaveAttribute('type', 'button');
200
+ });
201
+
202
+ it('as="div" is not given a type attribute', () => {
203
+ const { container } = render(<ListRow label="Row" />);
204
+ expect(container.firstElementChild!.hasAttribute('type')).toBe(false);
205
+ });
206
+
207
+ it('renders label, description and meta', () => {
208
+ render(<ListRow label="Name" description="Detail" meta={<span>12</span>} />);
209
+ expect(screen.getByText('Name')).toBeInTheDocument();
210
+ expect(screen.getByText('Detail')).toBeInTheDocument();
211
+ expect(screen.getByText('12')).toBeInTheDocument();
212
+ });
213
+
214
+ it('active is visual only and does not invent aria-current', () => {
215
+ const { container } = render(<ListRow label="Row" active />);
216
+ const root = container.firstElementChild!;
217
+ expect(root.className).toContain('bg-hover');
218
+ expect(root.hasAttribute('aria-current')).toBe(false);
219
+ });
220
+ });
221
+
222
+ describe('Badge', () => {
223
+ it.each([
224
+ ['neutral', 'bg-sunken'],
225
+ ['ok', 'bg-ok-soft'],
226
+ ['wait', 'bg-wait-soft'],
227
+ ['danger', 'bg-danger-soft'],
228
+ ['outline', 'border-line'],
229
+ ] as const)('tone %s uses a token background', (tone, expected) => {
230
+ const { container } = render(<Badge tone={tone}>x</Badge>);
231
+ expect(container.firstElementChild!.className).toContain(expected);
232
+ });
233
+
234
+ it('mono badges get the mono family for digit alignment', () => {
235
+ const { container } = render(<Badge mono>v1.2.0</Badge>);
236
+ expect(container.firstElementChild!.className).toContain('font-mono');
237
+ });
238
+ });
239
+
240
+ describe('Banner', () => {
241
+ it('renders nothing when it has no children', () => {
242
+ // 13 existing tests assert `container.firstChild` is null on conditional
243
+ // banners. A design-system wrapper that always renders a box breaks them.
244
+ const { container } = render(<Banner role="status">{null}</Banner>);
245
+ expect(container.firstChild).toBeNull();
246
+ });
247
+
248
+ it('renders nothing when children is false', () => {
249
+ const { container } = render(<Banner role="status">{false}</Banner>);
250
+ expect(container.firstChild).toBeNull();
251
+ });
252
+
253
+ it('is selectable by the role the caller chose', () => {
254
+ render(<Banner role="alert">Something broke</Banner>);
255
+ expect(screen.getByRole('alert')).toHaveTextContent('Something broke');
256
+ });
257
+
258
+ it('renders the leading icon slot', () => {
259
+ render(
260
+ <Banner role="status" icon={<span>!</span>}>
261
+ Note
262
+ </Banner>,
263
+ );
264
+ expect(screen.getByRole('status').textContent).toBe('!Note');
265
+ });
266
+ });
267
+
268
+ describe('Field', () => {
269
+ it('TextField defaults to type=text and forwards value/onChange', async () => {
270
+ const user = userEvent.setup();
271
+ const onChange = vi.fn();
272
+ render(<TextField aria-label="Search" onChange={onChange} />);
273
+ const input = screen.getByRole('textbox', { name: 'Search' });
274
+ expect(input).toHaveAttribute('type', 'text');
275
+ await user.type(input, 'ab');
276
+ expect(onChange).toHaveBeenCalledTimes(2);
277
+ });
278
+
279
+ it('uses an inset accent outline instead of a border-colour shift on focus', () => {
280
+ render(<TextField aria-label="Search" />);
281
+ const cls = screen.getByRole('textbox').className;
282
+ expect(cls).toContain('focus:outline-accent');
283
+ expect(cls).toContain('focus:border-transparent');
284
+ expect(cls).not.toMatch(/focus:border-slate/);
285
+ });
286
+
287
+ it('TextAreaField renders a textarea', () => {
288
+ render(<TextAreaField aria-label="Note" />);
289
+ expect(screen.getByRole('textbox', { name: 'Note' }).tagName).toBe('TEXTAREA');
290
+ });
291
+ });
292
+
293
+ describe('Menu', () => {
294
+ it('MenuPanel uses one radius/shadow pair for every menu in the app', () => {
295
+ const { container } = render(<MenuPanel>x</MenuPanel>);
296
+ const cls = container.firstElementChild!.className;
297
+ expect(cls).toContain('rounded-lg');
298
+ expect(cls).toContain('shadow-overlay');
299
+ });
300
+
301
+ it('MenuItem fires onClick and blocks it when disabled', async () => {
302
+ const user = userEvent.setup();
303
+ const onClick = vi.fn();
304
+ const { rerender } = render(<MenuItem onClick={onClick}>Rename</MenuItem>);
305
+ await user.click(screen.getByRole('button', { name: 'Rename' }));
306
+ expect(onClick).toHaveBeenCalledTimes(1);
307
+
308
+ rerender(
309
+ <MenuItem onClick={onClick} disabled>
310
+ Rename
311
+ </MenuItem>,
312
+ );
313
+ await user.click(screen.getByRole('button', { name: 'Rename' }));
314
+ expect(onClick).toHaveBeenCalledTimes(1);
315
+ });
316
+
317
+ it('MenuItem danger tone is distinguishable from default', () => {
318
+ const { container: a } = render(<MenuItem>Delete</MenuItem>);
319
+ const { container: b } = render(<MenuItem tone="danger">Delete</MenuItem>);
320
+ expect(a.firstElementChild!.className).not.toContain('text-danger');
321
+ expect(b.firstElementChild!.className).toContain('text-danger');
322
+ });
323
+
324
+ it('MenuItem renders the trailing adornment slot', () => {
325
+ render(<MenuItem trailing={<span>✓</span>}>Light</MenuItem>);
326
+ expect(screen.getByRole('button').textContent).toBe('Light✓');
327
+ });
328
+
329
+ it('MenuLabel renders its section heading', () => {
330
+ render(<MenuLabel>Appearance</MenuLabel>);
331
+ expect(screen.getByText('Appearance')).toBeInTheDocument();
332
+ });
333
+ });
@@ -0,0 +1,48 @@
1
+ /**
2
+ * The design system's public surface.
3
+ *
4
+ * This barrel is the ONLY path anything should import a primitive from —
5
+ * inside this package or outside it. Phase 2 of the UI migration has ~79
6
+ * files importing these components; keeping them behind one entry point is
7
+ * what lets the individual files be refactored later without a breaking
8
+ * change for every consumer.
9
+ *
10
+ * In-package: import { Button } from '../../shared/components';
11
+ * Downstream: import { Button } from '@bevel-software/platform-core-frontend/ui';
12
+ *
13
+ * Do NOT deep-import `shared/components/Button` — the `"./src/*"` export in
14
+ * package.json makes that technically possible and permanently unsupported.
15
+ */
16
+
17
+ export { Button, buttonClasses } from './Button';
18
+ export type { ButtonProps, ButtonVariant, ButtonSize } from './Button';
19
+
20
+ export { IconButton } from './IconButton';
21
+ export type { IconButtonProps, IconButtonSize } from './IconButton';
22
+
23
+ export { Surface } from './Surface';
24
+ export type { SurfaceProps, SurfaceTone, SurfaceRadius, SurfaceElevation } from './Surface';
25
+
26
+ export { ListRow } from './ListRow';
27
+ export type { ListRowProps, ListRowDensity } from './ListRow';
28
+
29
+ export { Badge } from './Badge';
30
+ export type { BadgeProps, BadgeTone, BadgeSize } from './Badge';
31
+
32
+ export { Banner } from './Banner';
33
+ export type { BannerProps, BannerTone } from './Banner';
34
+
35
+ export { TextField, TextAreaField } from './Field';
36
+ export type { TextFieldProps, TextAreaFieldProps } from './Field';
37
+
38
+ export { MenuPanel, MenuItem, MenuLabel } from './Menu';
39
+ export type { MenuPanelProps, MenuItemProps } from './Menu';
40
+
41
+ /* Pre-existing components that are part of the same surface. */
42
+ export { Dialog } from './Dialog';
43
+ export type { DialogSize } from './Dialog';
44
+ export { PageShell } from './PageShell';
45
+ export type { PageShellWidth } from './PageShell';
46
+ export { useModalLayer } from './useModalLayer';
47
+ export { useDismissableMenu } from './useDismissableMenu';
48
+ export type { DismissableMenuOptions } from './useDismissableMenu';
@@ -0,0 +1,71 @@
1
+ import { useEffect, useRef, type RefObject } from 'react';
2
+
3
+ /**
4
+ * The behaviour `MenuPanel` deliberately does not provide.
5
+ *
6
+ * Its own docstring is explicit: "MenuPanel is presentation only — it does not
7
+ * portal, trap focus, or own open state." That is the right call for a
8
+ * primitive (the app's menus anchor in four different ways), but it leaves
9
+ * every caller to re-implement the same three things. The prototype dismisses
10
+ * all of its menus on an outside click and on Escape (proto:4255-4273), and a
11
+ * menu you can only close by picking something is a trap for anyone driving
12
+ * the app from the keyboard.
13
+ *
14
+ * So: outside-click closes, Escape closes, and Escape returns focus to
15
+ * whatever opened the menu — otherwise focus is left on a node that just
16
+ * unmounted and the next Tab starts from the top of the document.
17
+ *
18
+ * Returns the ref to put on the panel.
19
+ */
20
+ export interface DismissableMenuOptions {
21
+ open: boolean;
22
+ onClose: () => void;
23
+ /**
24
+ * The control that opened the menu. Clicks on it are ignored (its own
25
+ * handler toggles), and Escape hands focus back to it.
26
+ */
27
+ returnFocusTo?: RefObject<HTMLElement | null>;
28
+ }
29
+
30
+ export function useDismissableMenu<T extends HTMLElement>({
31
+ open,
32
+ onClose,
33
+ returnFocusTo,
34
+ }: DismissableMenuOptions): RefObject<T | null> {
35
+ const panelRef = useRef<T>(null);
36
+
37
+ useEffect(() => {
38
+ if (!open) return;
39
+
40
+ function onPointerDown(e: MouseEvent) {
41
+ const target = e.target as Node;
42
+ if (panelRef.current?.contains(target)) return;
43
+ // A click on the trigger is the trigger's business — closing here too
44
+ // would make a toggle button close-then-reopen on a single click.
45
+ if (returnFocusTo?.current?.contains(target)) return;
46
+ onClose();
47
+ }
48
+
49
+ function onKey(e: KeyboardEvent) {
50
+ if (e.key !== 'Escape') return;
51
+ // Stops window-level Escape handlers from also acting on this key. It
52
+ // does NOT protect against a `<Dialog>` hosting the menu — Dialog binds
53
+ // on `document` too, and same-node listeners are unaffected by
54
+ // stopPropagation. Nothing here mounts a menu inside a dialog; if
55
+ // something ever does, the fix is `useModalLayer`, not a third
56
+ // listener.
57
+ e.stopPropagation();
58
+ onClose();
59
+ returnFocusTo?.current?.focus();
60
+ }
61
+
62
+ document.addEventListener('mousedown', onPointerDown);
63
+ document.addEventListener('keydown', onKey);
64
+ return () => {
65
+ document.removeEventListener('mousedown', onPointerDown);
66
+ document.removeEventListener('keydown', onKey);
67
+ };
68
+ }, [open, onClose, returnFocusTo]);
69
+
70
+ return panelRef;
71
+ }
@@ -0,0 +1,84 @@
1
+ /**
2
+ * The accent tokens must stay legible under white.
3
+ *
4
+ * Why a test and not a review habit: a contrast ratio is invisible to every
5
+ * gate the repo already has. Tailwind compiles `bg-accent` and `text-accent`
6
+ * whatever the value is, tsc has no opinion on hex, and the design-system
7
+ * ratchet counts OFF-system values — `bg-accent` is the on-system answer, so
8
+ * it stays silent no matter how light the token drifts. Nothing errors; the
9
+ * label just gets harder to read. Only measuring catches it.
10
+ *
11
+ * The accent is the one token where this matters, because it is the only one
12
+ * carrying both roles against the same white:
13
+ *
14
+ * bg-accent + text-white Button's primary variant and every control
15
+ * ported onto it (the prototype's `.btn.primary`)
16
+ * text-accent on canvas links, tab underlines, checkmarks, dirty dots
17
+ *
18
+ * Both are `--color-accent` vs `#ffffff`, so one ratio governs both and a
19
+ * single token edit is what fixes them. Threshold is WCAG AA for normal text
20
+ * (4.5:1), not large text (3:1), because these labels are text-xs/text-sm.
21
+ */
22
+ import { describe, it, expect } from 'vitest';
23
+ import { readFileSync } from 'node:fs';
24
+ import { dirname, join } from 'node:path';
25
+ import { fileURLToPath } from 'node:url';
26
+
27
+ // Resolved off this file rather than `process.cwd()` so the test does not
28
+ // care which directory vitest was launched from. Deliberately NOT written as
29
+ // `new URL('../tokens.css', import.meta.url)`: Vite rewrites that exact
30
+ // pattern into an asset URL, and the http-scheme result fails fileURLToPath.
31
+ const TOKENS = readFileSync(
32
+ join(dirname(fileURLToPath(import.meta.url)), '..', 'tokens.css'),
33
+ 'utf8',
34
+ );
35
+
36
+ /** Reads a token's literal off its declaration, ignoring hex in comments. */
37
+ function token(name: string): string {
38
+ const match = TOKENS.match(
39
+ new RegExp(`^\\s*--color-${name}:\\s*(#[0-9a-fA-F]{6})\\s*;`, 'm'),
40
+ );
41
+ if (!match) throw new Error(`--color-${name} not found in tokens.css`);
42
+ return match[1];
43
+ }
44
+
45
+ /** WCAG 2.1 relative luminance. */
46
+ function luminance(hex: string): number {
47
+ const channels = [1, 3, 5].map((i) => parseInt(hex.slice(i, i + 2), 16) / 255);
48
+ const [r, g, b] = channels.map((c) =>
49
+ c <= 0.04045 ? c / 12.92 : ((c + 0.055) / 1.055) ** 2.4,
50
+ );
51
+ return 0.2126 * r + 0.7152 * g + 0.0722 * b;
52
+ }
53
+
54
+ function contrast(a: string, b: string): number {
55
+ const [hi, lo] = [luminance(a), luminance(b)].sort((x, y) => y - x);
56
+ return (hi + 0.05) / (lo + 0.05);
57
+ }
58
+
59
+ const WHITE = '#ffffff';
60
+ const AA_NORMAL_TEXT = 4.5;
61
+
62
+ describe('accent contrast', () => {
63
+ // Self-check: the formula reproduces two published ratios, so a failure
64
+ // below is the token moving rather than the maths rotting.
65
+ it('computes known WCAG ratios', () => {
66
+ expect(contrast('#000000', WHITE)).toBeCloseTo(21, 5);
67
+ expect(contrast(WHITE, WHITE)).toBeCloseTo(1, 5);
68
+ });
69
+
70
+ it.each(['accent', 'accent-hover'])(
71
+ '--color-%s clears AA against white',
72
+ (name) => {
73
+ expect(contrast(token(name), WHITE)).toBeGreaterThanOrEqual(AA_NORMAL_TEXT);
74
+ },
75
+ );
76
+
77
+ // The hover step is an affordance: it has to be visible, and it has to go
78
+ // the same direction the prototype's did (darker, never lighter). Equal
79
+ // ratios would pass the check above while rendering as no feedback at all.
80
+ it('accent-hover is perceptibly darker than accent', () => {
81
+ expect(luminance(token('accent-hover'))).toBeLessThan(luminance(token('accent')));
82
+ expect(contrast(token('accent'), token('accent-hover'))).toBeGreaterThan(1.1);
83
+ });
84
+ });
@@ -0,0 +1,12 @@
1
+ /**
2
+ * The design system's stylesheet: tokens only, no app chrome.
3
+ *
4
+ * Import this to get the token vocabulary without the application's base
5
+ * styles (resets, scrollbars, prose theming) — those live in the package's
6
+ * top-level `src/index.css`, which imports this file.
7
+ *
8
+ * Consumers reach this as `@bevel-software/platform-core-frontend/theme.css`.
9
+ */
10
+
11
+ @import './tokens.css';
12
+ @import './shadows.css';