@bevel-software/platform-core-frontend 0.4.1 → 0.5.1

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 (327) hide show
  1. package/THIRD-PARTY-NOTICES.md +5366 -0
  2. package/package.json +7 -4
  3. package/src/core/CoreAppShell.tsx +195 -56
  4. package/src/core/__tests__/AppChrome.test.tsx +125 -0
  5. package/src/core/__tests__/ShellRoutes.test.tsx +37 -2
  6. package/src/core/__tests__/bootstrap.test.ts +63 -0
  7. package/src/core/bootstrap.ts +73 -0
  8. package/src/core/events.ts +12 -0
  9. package/src/core/registry.ts +58 -9
  10. package/src/index.css +100 -11
  11. package/src/index.ts +24 -23
  12. package/src/lib/utils.ts +93 -117
  13. package/src/modules/access/__tests__/ManageAccessDialog.placement.test.tsx +281 -0
  14. package/src/modules/access/__tests__/ManageAccessDialog.test.tsx +166 -1
  15. package/src/modules/access/api.ts +49 -0
  16. package/src/modules/access/components/ManageAccessDialog.tsx +786 -481
  17. package/src/modules/access/hooks/useFileAccess.ts +1 -1
  18. package/src/modules/admin/__tests__/AdminRolesPage.suggest.test.tsx +86 -0
  19. package/src/modules/admin/__tests__/UserAccountsPage.test.tsx +17 -1
  20. package/src/modules/admin/__tests__/admin.unread.test.tsx +61 -0
  21. package/src/modules/admin/components/AdminRolesPage.tsx +44 -38
  22. package/src/modules/admin/components/RolesCorruptedBanner.tsx +11 -10
  23. package/src/modules/admin/components/UserAccountsPage.tsx +36 -28
  24. package/src/modules/admin/state/admin.context.tsx +15 -6
  25. package/src/modules/auth/components/AccountPage.tsx +11 -11
  26. package/src/modules/auth/components/LoginScreen.tsx +12 -12
  27. package/src/modules/auth/services/sso.ts +47 -1
  28. package/src/modules/change-requests/__tests__/ChangeRequestDialog.test.tsx +277 -0
  29. package/src/modules/change-requests/__tests__/author.test.ts +48 -0
  30. package/src/modules/change-requests/__tests__/conflict.test.ts +73 -0
  31. package/src/modules/change-requests/__tests__/diff.test.ts +134 -0
  32. package/src/modules/change-requests/__tests__/propose.test.ts +93 -0
  33. package/src/modules/change-requests/__tests__/useFileOnBranch.test.tsx +72 -0
  34. package/src/modules/change-requests/change-requests.css +22 -0
  35. package/src/modules/change-requests/components/ChangeBox.tsx +277 -0
  36. package/src/modules/change-requests/components/ChangeRequestDialog.tsx +713 -0
  37. package/src/modules/change-requests/components/ConflictHelp.tsx +47 -0
  38. package/src/modules/change-requests/components/CrFileTree.tsx +398 -0
  39. package/src/modules/change-requests/components/FileChangeBoxes.tsx +168 -0
  40. package/src/modules/change-requests/hooks/useApplyChangeRequest.ts +236 -0
  41. package/src/modules/change-requests/hooks/useCrFileDiffs.ts +79 -0
  42. package/src/modules/change-requests/hooks/useFileOnBranch.ts +80 -0
  43. package/src/modules/change-requests/services/change-requests.api.ts +45 -0
  44. package/src/modules/change-requests/services/propose.api.ts +162 -0
  45. package/src/modules/change-requests/utils/author.ts +47 -0
  46. package/src/modules/change-requests/utils/conflict.ts +38 -0
  47. package/src/modules/change-requests/utils/diff.ts +80 -0
  48. package/src/modules/git/__tests__/BranchSwitcher.test.tsx +27 -18
  49. package/src/modules/git/__tests__/FileHistoryPanel.test.tsx +36 -83
  50. package/src/modules/git/__tests__/PullNeededBanner.test.tsx +5 -5
  51. package/src/modules/git/__tests__/PullRequestsForMe.test.tsx +147 -0
  52. package/src/modules/git/__tests__/useAutoPullUpdates.test.tsx +2 -8
  53. package/src/modules/git/components/BranchSwitcher.tsx +68 -31
  54. package/src/modules/git/components/DiffView.tsx +4 -4
  55. package/src/modules/git/components/FileComparisonPanel.tsx +20 -20
  56. package/src/modules/git/components/FileHistoryPanel.tsx +71 -107
  57. package/src/modules/git/components/PullNeededBanner.tsx +6 -13
  58. package/src/modules/git/components/PullRequestsForMe.tsx +71 -36
  59. package/src/modules/git/components/UnifiedDiffView.tsx +4 -4
  60. package/src/modules/git/hooks/__tests__/useGitState.deleteBranch.test.tsx +2 -2
  61. package/src/modules/git/hooks/useGitState.ts +15 -14
  62. package/src/modules/git/services/__tests__/error-messages.test.ts +4 -4
  63. package/src/modules/git/services/error-messages.ts +7 -7
  64. package/src/modules/git/services/git.api.ts +17 -11
  65. package/src/modules/git/services/pr-prompts.ts +2 -2
  66. package/src/modules/git/state/git.context.ts +10 -1
  67. package/src/modules/layout/__tests__/SidebarFrameResponsive.test.tsx +224 -0
  68. package/src/modules/layout/__tests__/SidebarToggle.test.tsx +242 -0
  69. package/src/modules/layout/__tests__/breakpoints.test.ts +56 -0
  70. package/src/modules/layout/breakpoints.ts +6 -0
  71. package/src/modules/layout/components/AppLayout.tsx +17 -5
  72. package/src/modules/layout/components/DemoBanner.tsx +10 -1
  73. package/src/modules/layout/components/MaintenanceOverlay.tsx +3 -3
  74. package/src/modules/layout/components/MobileChatLayout.tsx +31 -26
  75. package/src/modules/layout/components/ResizableThreePaneLayout.tsx +59 -24
  76. package/src/modules/layout/components/SidebarFrame.tsx +317 -0
  77. package/src/modules/layout/components/SidebarToggle.tsx +86 -0
  78. package/src/modules/layout/components/SlideOverlay.tsx +1 -1
  79. package/src/modules/layout/components/__tests__/MobileChatLayout.test.tsx +40 -2
  80. package/src/modules/layout/components/__tests__/ResizableThreePaneLayout.test.tsx +19 -3
  81. package/src/modules/layout/state/sidebar.ts +200 -0
  82. package/src/modules/library/__tests__/AddToGroupDialog.test.tsx +313 -0
  83. package/src/modules/library/__tests__/ChangeRequestDock.test.tsx +84 -0
  84. package/src/modules/library/__tests__/GroupJoinRequests.test.tsx +178 -0
  85. package/src/modules/library/__tests__/GroupPage.test.tsx +479 -0
  86. package/src/modules/library/__tests__/GroupsIndexPage.test.tsx +283 -0
  87. package/src/modules/library/__tests__/GroupsSidebar.contextmenu.test.tsx +175 -0
  88. package/src/modules/library/__tests__/GroupsSidebar.locked.test.tsx +96 -0
  89. package/src/modules/library/__tests__/GroupsSidebar.test.tsx +142 -0
  90. package/src/modules/library/__tests__/GroupsSidebarMenu.test.tsx +142 -0
  91. package/src/modules/library/__tests__/LibraryCard.test.tsx +149 -0
  92. package/src/modules/library/__tests__/LibraryRoutes.test.tsx +378 -0
  93. package/src/modules/library/__tests__/LibrarySidebarMenu.test.tsx +347 -0
  94. package/src/modules/library/__tests__/LockedGroupView.test.tsx +203 -0
  95. package/src/modules/library/__tests__/NewGroupDialog.test.tsx +114 -0
  96. package/src/modules/library/__tests__/PersonalAddDialog.test.tsx +177 -0
  97. package/src/modules/library/__tests__/SkillPage.test.tsx +1063 -0
  98. package/src/modules/library/__tests__/ToolConnectionSection.test.tsx +259 -0
  99. package/src/modules/library/__tests__/ToolLogo.test.tsx +63 -0
  100. package/src/modules/library/__tests__/ToolPage.test.tsx +315 -0
  101. package/src/modules/library/__tests__/ToolSharePanel.test.tsx +36 -0
  102. package/src/modules/library/__tests__/ToolVarRow.test.tsx +260 -0
  103. package/src/modules/library/__tests__/WorkspaceItemRoute.test.tsx +197 -0
  104. package/src/modules/library/__tests__/auth-harness.tsx +37 -0
  105. package/src/modules/library/__tests__/oauth-fragment.test.ts +48 -0
  106. package/src/modules/library/__tests__/status.test.ts +113 -20
  107. package/src/modules/library/__tests__/useSkillDetail.test.tsx +102 -0
  108. package/src/modules/library/__tests__/useToolPage.test.tsx +146 -0
  109. package/src/modules/library/components/AccessRequestsBanner.tsx +101 -0
  110. package/src/modules/library/components/AddToGroupDialog.tsx +115 -0
  111. package/src/modules/library/components/ChangeRequestDock.tsx +52 -28
  112. package/src/modules/library/components/DeleteGroupDialog.tsx +87 -0
  113. package/src/modules/library/components/GroupIndexRow.tsx +63 -0
  114. package/src/modules/library/components/GroupJoinRequests.tsx +56 -0
  115. package/src/modules/library/components/GroupPage.tsx +373 -0
  116. package/src/modules/library/components/GroupsIndexPage.tsx +222 -0
  117. package/src/modules/library/components/GroupsSidebar.tsx +338 -0
  118. package/src/modules/library/components/GroupsSidebarMenu.tsx +160 -0
  119. package/src/modules/library/components/LibraryCard.tsx +123 -102
  120. package/src/modules/library/components/LibraryLayout.tsx +344 -0
  121. package/src/modules/library/components/LibraryPage.tsx +111 -227
  122. package/src/modules/library/components/LockGlyph.tsx +31 -0
  123. package/src/modules/library/components/LockedGroupView.tsx +159 -0
  124. package/src/modules/library/components/ManagedGroupRequests.tsx +70 -0
  125. package/src/modules/library/components/NewGroupDialog.tsx +112 -0
  126. package/src/modules/library/components/NewSkillPanel.tsx +151 -0
  127. package/src/modules/library/components/PageActions.tsx +156 -0
  128. package/src/modules/library/components/PendingSkillReview.tsx +63 -0
  129. package/src/modules/library/components/PersonalAddDialog.tsx +88 -0
  130. package/src/modules/library/components/PersonalGroupPage.tsx +125 -0
  131. package/src/modules/library/components/StatusDot.tsx +25 -0
  132. package/src/modules/library/components/ToolLogo.tsx +171 -0
  133. package/src/modules/library/components/group-page-parts.tsx +419 -0
  134. package/src/modules/library/components/skill-page/SkillFileEditor.tsx +134 -0
  135. package/src/modules/library/components/skill-page/SkillFilePane.tsx +117 -0
  136. package/src/modules/library/components/skill-page/SkillFileTabs.tsx +112 -0
  137. package/src/modules/library/components/skill-page/SkillPage.tsx +673 -0
  138. package/src/modules/library/components/skill-page/tab-ids.ts +33 -0
  139. package/src/modules/library/components/tool-page/ToolConnectionSection.tsx +175 -0
  140. package/src/modules/library/components/tool-page/ToolPage.tsx +228 -0
  141. package/src/modules/library/components/tool-page/ToolSharePanel.tsx +45 -0
  142. package/src/modules/library/components/tool-page/ToolVarRow.tsx +289 -0
  143. package/src/modules/library/hooks/useJoinRequests.ts +114 -0
  144. package/src/modules/library/hooks/useLibraryData.ts +134 -119
  145. package/src/modules/library/hooks/useSkillDetail.ts +119 -74
  146. package/src/modules/library/hooks/useToolPage.ts +145 -0
  147. package/src/modules/library/library.css +33 -245
  148. package/src/modules/library/routes/LibraryRoutes.tsx +134 -0
  149. package/src/modules/library/routes/WorkspaceItemRoute.tsx +74 -0
  150. package/src/modules/library/routes/library-paths.ts +191 -0
  151. package/src/modules/library/services/groups.api.ts +189 -0
  152. package/src/modules/library/services/library.api.ts +291 -164
  153. package/src/modules/library/services/tools.api.ts +60 -0
  154. package/src/modules/library/state/library-context.ts +22 -0
  155. package/src/modules/library/state/library-data.tsx +223 -0
  156. package/src/modules/library/state/toast.context.ts +32 -0
  157. package/src/modules/library/state/toast.tsx +84 -42
  158. package/src/modules/library/utils/clipboard.ts +33 -0
  159. package/src/modules/library/utils/group-summary.ts +68 -0
  160. package/src/modules/library/utils/names.ts +30 -0
  161. package/src/modules/library/utils/navigate-external.ts +15 -0
  162. package/src/modules/library/utils/oauth-fragment.ts +32 -0
  163. package/src/modules/library/utils/personal-group.ts +36 -0
  164. package/src/modules/library/utils/status.ts +108 -25
  165. package/src/modules/library/utils/toast-duration.ts +16 -0
  166. package/src/modules/onboarding/__tests__/onboarding.test.tsx +533 -0
  167. package/src/modules/onboarding/agent-clients.ts +48 -0
  168. package/src/modules/onboarding/components/ConnectAgentPill.tsx +133 -0
  169. package/src/modules/onboarding/components/RootLanding.tsx +54 -0
  170. package/src/modules/onboarding/components/WelcomePage.tsx +364 -0
  171. package/src/modules/onboarding/paths.ts +9 -0
  172. package/src/modules/onboarding/state/onboarding.ts +191 -0
  173. package/src/modules/pr/components/OpenChangeRequestDialog.tsx +10 -10
  174. package/src/modules/pr/services/pr-approvals.api.ts +19 -0
  175. package/src/modules/pr/services/pr-cancel.api.ts +11 -0
  176. package/src/modules/review/components/BinaryChangePlaceholder.tsx +3 -3
  177. package/src/modules/review/components/DiffViewer.tsx +4 -4
  178. package/src/modules/review/components/MarkdownDiffViewer.tsx +84 -26
  179. package/src/modules/review/components/ReviewFileRow.tsx +10 -10
  180. package/src/modules/review/components/ReviewPanel.tsx +49 -17
  181. package/src/modules/review/components/ReviewPanelSurface.tsx +1 -1
  182. package/src/modules/review/components/__tests__/MarkdownDiffViewer.test.tsx +122 -0
  183. package/src/modules/review/hooks/__tests__/useReviewState.test.ts +1 -1
  184. package/src/modules/secrets-vault/components/ConnectToolsPage.tsx +273 -171
  185. package/src/modules/secrets-vault/components/SecretsPage.tsx +147 -110
  186. package/src/modules/secrets-vault/components/ToolSecretsPanel.tsx +109 -92
  187. package/src/modules/secrets-vault/components/__tests__/SecretsPage.test.tsx +35 -4
  188. package/src/modules/secrets-vault/services/connect.api.ts +24 -3
  189. package/src/modules/settings/components/DeploymentPage.tsx +90 -0
  190. package/src/modules/settings/components/SettingsLayout.tsx +135 -0
  191. package/src/modules/settings/components/SettingsNav.tsx +114 -0
  192. package/src/modules/settings/components/__tests__/DeploymentPage.test.tsx +110 -0
  193. package/src/modules/settings/components/__tests__/SettingsLayout.test.tsx +249 -0
  194. package/src/modules/settings/settings-nav-items.tsx +166 -0
  195. package/src/modules/setup/__tests__/setup.test.tsx +540 -0
  196. package/src/modules/setup/components/SetupGate.tsx +67 -0
  197. package/src/modules/setup/components/SetupScreen.tsx +573 -0
  198. package/src/modules/setup/services/setup.api.ts +106 -0
  199. package/src/modules/setup/utils/git-host.ts +34 -0
  200. package/src/modules/toolbar/components/AppSwitcher.tsx +38 -15
  201. package/src/modules/toolbar/components/ExternalAgentAccessPage.tsx +50 -50
  202. package/src/modules/toolbar/components/ProfileMenu.tsx +294 -0
  203. package/src/modules/toolbar/components/Toolbar.tsx +56 -54
  204. package/src/modules/toolbar/components/__tests__/AppSwitcher.test.tsx +176 -122
  205. package/src/modules/toolbar/components/__tests__/Toolbar.test.tsx +252 -77
  206. package/src/modules/tools/ToolsExplorerPage.tsx +45 -40
  207. package/src/modules/workspace/__tests__/design-system-parity.test.ts +133 -0
  208. package/src/modules/workspace/__tests__/testFixtures.ts +2 -0
  209. package/src/modules/workspace/components/EditorTabs.tsx +82 -50
  210. package/src/modules/workspace/components/FileExplorer.tsx +413 -189
  211. package/src/modules/workspace/components/FilePaneCard.tsx +53 -0
  212. package/src/modules/workspace/components/FileRoute.tsx +89 -84
  213. package/src/modules/workspace/components/FileViewer.tsx +700 -294
  214. package/src/modules/workspace/components/KbDocumentShell.tsx +138 -0
  215. package/src/modules/workspace/components/KbFileRail.tsx +128 -0
  216. package/src/modules/workspace/components/KbPageHeader.tsx +390 -0
  217. package/src/modules/workspace/components/__tests__/EditorTabs.test.tsx +87 -3
  218. package/src/modules/workspace/components/__tests__/FileExplorer.test.tsx +293 -39
  219. package/src/modules/workspace/components/__tests__/FileRoute.test.tsx +1 -16
  220. package/src/modules/workspace/components/__tests__/FileViewer.test.tsx +462 -44
  221. package/src/modules/workspace/components/__tests__/KbDocumentShell.test.tsx +84 -0
  222. package/src/modules/workspace/components/__tests__/KbFileRail.test.tsx +83 -0
  223. package/src/modules/workspace/components/__tests__/KbPageHeader.test.tsx +192 -0
  224. package/src/modules/workspace/components/renderers/CopyAnchorButton.tsx +64 -0
  225. package/src/modules/workspace/components/renderers/CsvRenderer.tsx +8 -8
  226. package/src/modules/workspace/components/renderers/DocxRenderer.tsx +18 -9
  227. package/src/modules/workspace/components/renderers/HtmlRenderer.tsx +14 -14
  228. package/src/modules/workspace/components/renderers/ImageRenderer.tsx +2 -2
  229. package/src/modules/workspace/components/renderers/KbMarkdownView.tsx +31 -165
  230. package/src/modules/workspace/components/renderers/MarkdownRenderer.tsx +18 -5
  231. package/src/modules/workspace/components/renderers/MermaidDiagram.tsx +27 -10
  232. package/src/modules/workspace/components/renderers/PdfRenderer.tsx +2 -2
  233. package/src/modules/workspace/components/renderers/TextRenderer.tsx +11 -5
  234. package/src/modules/workspace/components/renderers/ToolForm.tsx +24 -24
  235. package/src/modules/workspace/components/renderers/ToolRenderer.tsx +27 -27
  236. package/src/modules/workspace/components/renderers/XlsxRenderer.tsx +11 -11
  237. package/src/modules/workspace/components/renderers/__tests__/DocxRenderer.test.tsx +66 -0
  238. package/src/modules/workspace/components/renderers/__tests__/KbMarkdownView.test.tsx +17 -1
  239. package/src/modules/workspace/components/renderers/__tests__/MarkdownRenderer.test.tsx +1 -1
  240. package/src/modules/workspace/components/renderers/__tests__/MermaidDiagram.test.tsx +58 -0
  241. package/src/modules/workspace/components/renderers/__tests__/lazyRenderer.test.tsx +68 -0
  242. package/src/modules/workspace/components/renderers/__tests__/rendererLayout.test.ts +64 -0
  243. package/src/modules/workspace/components/renderers/__tests__/sanitizeDocxHtml.test.ts +0 -0
  244. package/src/modules/workspace/components/renderers/chunk-boundary.tsx +71 -0
  245. package/src/modules/workspace/components/renderers/index.ts +78 -2
  246. package/src/modules/workspace/components/renderers/kbMarkdownPipeline.tsx +241 -0
  247. package/src/modules/workspace/components/renderers/lazyRenderer.tsx +59 -0
  248. package/src/modules/workspace/components/renderers/sanitizeDocxHtml.ts +91 -0
  249. package/src/modules/workspace/hooks/__tests__/useLinksOut.test.ts +59 -0
  250. package/src/modules/workspace/hooks/__tests__/useOpenChangeRequests.test.tsx +237 -0
  251. package/src/modules/workspace/hooks/__tests__/useWorkspaceState.test.tsx +185 -0
  252. package/src/modules/workspace/hooks/useAutoGrowTextarea.ts +30 -0
  253. package/src/modules/workspace/hooks/useLastCommit.ts +66 -0
  254. package/src/modules/workspace/hooks/useLinksOut.ts +56 -0
  255. package/src/modules/workspace/hooks/useOpenChangeRequests.ts +20 -0
  256. package/src/modules/workspace/hooks/useWorkspaceState.ts +123 -14
  257. package/src/modules/workspace/routing/__tests__/kb-routes.test.tsx +1 -1
  258. package/src/modules/workspace/services/workspace.api.ts +9 -2
  259. package/src/modules/workspace/state/open-change-requests.context.ts +35 -0
  260. package/src/modules/workspace/state/open-change-requests.tsx +185 -0
  261. package/src/modules/workspace/state/workspace.context.ts +9 -0
  262. package/src/modules/workspace/utils/__tests__/diff.test.ts +87 -0
  263. package/src/modules/workspace/utils/diff.ts +130 -53
  264. package/src/modules/workspace/utils/fileTree.ts +7 -4
  265. package/src/modules/workspace/workspace.css +28 -0
  266. package/src/shared/components/Badge.tsx +62 -0
  267. package/src/shared/components/Banner.tsx +58 -0
  268. package/src/shared/components/Button.tsx +90 -0
  269. package/src/shared/components/Dialog.tsx +6 -6
  270. package/src/shared/components/Field.tsx +45 -0
  271. package/src/shared/components/IconButton.tsx +74 -0
  272. package/src/shared/components/ListRow.tsx +96 -0
  273. package/src/shared/components/Menu.tsx +88 -0
  274. package/src/shared/components/PageShell.tsx +8 -5
  275. package/src/shared/components/Surface.tsx +86 -0
  276. package/src/shared/components/__tests__/primitives.test.tsx +333 -0
  277. package/src/shared/components/index.ts +48 -0
  278. package/src/shared/components/useDismissableMenu.ts +71 -0
  279. package/src/shared/theme/__tests__/accent-contrast.test.ts +84 -0
  280. package/src/shared/theme/index.css +12 -0
  281. package/src/shared/theme/measure.ts +64 -0
  282. package/src/shared/theme/shadows.css +34 -0
  283. package/src/shared/theme/tokens.css +193 -0
  284. package/src/test-setup.ts +9 -0
  285. package/src/modules/access/components/AccessRestrictedBanner.tsx +0 -31
  286. package/src/modules/access/components/NodeOwnersBanner.tsx +0 -30
  287. package/src/modules/git/__tests__/ProtectedBranchBanner.test.tsx +0 -82
  288. package/src/modules/git/components/ProtectedBranchBanner.tsx +0 -42
  289. package/src/modules/library/__tests__/DetailDialog.test.tsx +0 -200
  290. package/src/modules/library/__tests__/diff.test.ts +0 -62
  291. package/src/modules/library/__tests__/loadout.test.tsx +0 -72
  292. package/src/modules/library/components/CompareView.tsx +0 -357
  293. package/src/modules/library/components/DetailDialog.tsx +0 -566
  294. package/src/modules/library/components/GearIcon.tsx +0 -12
  295. package/src/modules/library/components/LoadoutSidebar.tsx +0 -156
  296. package/src/modules/library/components/StatusGem.tsx +0 -21
  297. package/src/modules/library/components/SuggestChange.tsx +0 -171
  298. package/src/modules/library/components/particles.ts +0 -50
  299. package/src/modules/library/state/loadout.tsx +0 -129
  300. package/src/modules/library/utils/diff.ts +0 -102
  301. package/src/modules/pr/__tests__/PrApprovalBadge.test.tsx +0 -93
  302. package/src/modules/pr/__tests__/PrCancelButton.test.tsx +0 -158
  303. package/src/modules/pr/__tests__/PrCancelConfirmDialog.test.tsx +0 -44
  304. package/src/modules/pr/__tests__/PrMergeButton.test.tsx +0 -360
  305. package/src/modules/pr/__tests__/bucketize-comments.test.ts +0 -85
  306. package/src/modules/pr/__tests__/parsePatch.test.ts +0 -104
  307. package/src/modules/pr/__tests__/usePrViewerState.test.ts +0 -72
  308. package/src/modules/pr/components/PrApprovalBadge.tsx +0 -80
  309. package/src/modules/pr/components/PrCancelButton.tsx +0 -99
  310. package/src/modules/pr/components/PrCancelConfirmDialog.tsx +0 -119
  311. package/src/modules/pr/components/PrCommentComposer.tsx +0 -92
  312. package/src/modules/pr/components/PrCommentThread.tsx +0 -168
  313. package/src/modules/pr/components/PrCommentsPanel.tsx +0 -143
  314. package/src/modules/pr/components/PrDiffPane.tsx +0 -425
  315. package/src/modules/pr/components/PrFileRow.tsx +0 -164
  316. package/src/modules/pr/components/PrFilesList.tsx +0 -53
  317. package/src/modules/pr/components/PrHeader.tsx +0 -45
  318. package/src/modules/pr/components/PrHeaderOverflowMenu.tsx +0 -58
  319. package/src/modules/pr/components/PrMergeButton.tsx +0 -268
  320. package/src/modules/pr/components/PrMergeConfirmDialog.tsx +0 -112
  321. package/src/modules/pr/components/PrRefreshFromTargetButton.tsx +0 -110
  322. package/src/modules/pr/components/PrViewer.tsx +0 -364
  323. package/src/modules/pr/hooks/usePrViewerState.ts +0 -150
  324. package/src/modules/pr/state/pr-viewer.context.ts +0 -34
  325. package/src/modules/pr/utils/bucketize-comments.ts +0 -55
  326. package/src/modules/pr/utils/parsePatch.ts +0 -57
  327. package/src/modules/toolbar/components/AdminMenu.tsx +0 -271
@@ -0,0 +1,223 @@
1
+ import { useCallback, useContext, useEffect, useMemo, useState, type ReactNode, } from 'react';
2
+ import { LibraryContext } from './library-context';
3
+ import { groupOfPath, isPersonalGroupFolder } from '@bevel-software/platform-shared';
4
+
5
+ /**
6
+ * The group a card files under — with personal folders mapped to `null`, the
7
+ * "yours alone" bucket. A personal folder (`Groups/personal-<id>/`) is where
8
+ * a person's own skills live; it is a place, not a group, and the only
9
+ * personal items a caller can ever read are their own (the folder's seeded
10
+ * access.md names nobody else), so `null` here always means "yours".
11
+ */
12
+ function displayGroupOf(path: string): string | null {
13
+ const group = groupOfPath(path);
14
+ return group !== null && isPersonalGroupFolder(group) ? null : group;
15
+ }
16
+ import { useLibraryData, type LibraryData } from '../hooks/useLibraryData';
17
+ import { listGroups, type GroupSummary } from '../services/groups.api';
18
+ import {
19
+ neededToolsFor,
20
+ skillStatus,
21
+ toolStatus,
22
+ type AttentionStatus,
23
+ } from '../utils/status';
24
+
25
+ /**
26
+ * The Library's data host.
27
+ *
28
+ * Everything under `/skills-and-tools/*` — the gallery, the group pages, the
29
+ * all-groups index — reads the SAME catalog, so it is fetched once here rather
30
+ * than once per page. That matters more than it looks: `useLibraryData` pays an
31
+ * N+1 `getSkill` to read `allowed-tools` frontmatter, and mounting it per route
32
+ * would re-pay it on every navigation.
33
+ *
34
+ * Two independent loads live side by side:
35
+ * - the catalog (`useLibraryData`), whose failure IS surfaced (the gallery
36
+ * shows a banner — an empty library is indistinguishable from a broken one);
37
+ * - the group index (`GET /api/groups`), whose failure degrades to `[]` and is
38
+ * reported through `groupsError` for the surfaces that want to say so.
39
+ */
40
+
41
+ /** One card in the gallery — a skill or an integration, already status-derived. */
42
+ export interface LibraryItem {
43
+ kind: 'skill' | 'integration';
44
+ id: string;
45
+ name: string;
46
+ description: string;
47
+ owned: boolean;
48
+ status: AttentionStatus;
49
+ /** Folder group from the KB path, or null when the item is in none. */
50
+ group: string | null;
51
+ /** Repo-root-relative path — the skill's folder, or the `.tool` file. */
52
+ path: string;
53
+ /**
54
+ * A skill's declared `version:` frontmatter. Undefined for integrations, and
55
+ * for the many skills that declare none — the field is optional all the way
56
+ * down from `SKILL.md`, so absence is the normal case, not a load failure.
57
+ */
58
+ version?: string;
59
+ /**
60
+ * Set only on a skill that does not exist yet — it lives on an open change
61
+ * request's branch and is waiting on somebody to approve it.
62
+ *
63
+ * Deliberately NOT folded into `status`: `AttentionStatus` answers "is
64
+ * anything standing in this item's way?", which drives the setup filter and
65
+ * the amber counts, and a skill under review is not a broken skill. Callers
66
+ * that must treat a proposal differently — the card, the click — read this.
67
+ */
68
+ pending?: {
69
+ changeRequestNumber: number;
70
+ branch: string;
71
+ authorName: string;
72
+ /** True when the reader proposed it themselves. */
73
+ mine: boolean;
74
+ };
75
+ }
76
+
77
+ export interface LibraryContextValue extends LibraryData {
78
+ items: LibraryItem[];
79
+ /** `[]` until loaded, and on error. */
80
+ groupSummaries: GroupSummary[];
81
+ groupsLoading: boolean;
82
+ groupsError: string | null;
83
+ reloadGroups(): void;
84
+ }
85
+
86
+
87
+ export function LibraryProvider({ children }: { children: ReactNode }) {
88
+ const data = useLibraryData();
89
+ const [groupSummaries, setGroupSummaries] = useState<GroupSummary[]>([]);
90
+ const [groupsLoading, setGroupsLoading] = useState(true);
91
+ const [groupsError, setGroupsError] = useState<string | null>(null);
92
+ const [groupsRevision, setGroupsRevision] = useState(0);
93
+
94
+ useEffect(() => {
95
+ let cancelled = false;
96
+ listGroups()
97
+ .then((groups) => {
98
+ if (cancelled) return;
99
+ setGroupSummaries(groups);
100
+ setGroupsError(null);
101
+ })
102
+ .catch((err: unknown) => {
103
+ if (cancelled) return;
104
+ // Keep whatever we had: a transient failure on a manual reload should
105
+ // not blank a list the user is looking at.
106
+ setGroupsError(err instanceof Error ? err.message : "Couldn't load groups.");
107
+ })
108
+ .finally(() => {
109
+ if (!cancelled) setGroupsLoading(false);
110
+ });
111
+ return () => {
112
+ cancelled = true;
113
+ };
114
+ }, [groupsRevision]);
115
+
116
+ const items: LibraryItem[] = useMemo(() => {
117
+ const skillItems: LibraryItem[] = data.skills.map((s) => ({
118
+ kind: 'skill',
119
+ id: s.name,
120
+ name: s.name,
121
+ description: s.description,
122
+ owned: data.ownedSkills.has(s.name),
123
+ group: displayGroupOf(s.path),
124
+ path: s.path,
125
+ version: s.version,
126
+ status: skillStatus(
127
+ neededToolsFor({ allowedTools: data.allowedToolsBySkill.get(s.name) }, data.tools),
128
+ ),
129
+ }));
130
+ /**
131
+ * Proposed skills, alongside the released ones rather than in a pile of
132
+ * their own. The question "is this skill available?" is asked in the same
133
+ * place as "does this group have one?", and a separate shelf answers the
134
+ * second while hiding the first — which is exactly the failure this fixes:
135
+ * a skill an agent proposed was nowhere at all until it merged.
136
+ *
137
+ * `status` is the neutral `ok`: a proposal has no integrations resolved
138
+ * against it, and reporting `warn` would put it in the setup filter and the
139
+ * group's amber count as though something were broken.
140
+ */
141
+ const pendingItems: LibraryItem[] = data.pendingSkills.map((s) => ({
142
+ kind: 'skill',
143
+ id: s.name,
144
+ name: s.name,
145
+ description: s.description,
146
+ owned: false,
147
+ group: displayGroupOf(s.path),
148
+ path: s.path,
149
+ version: s.version,
150
+ status: { state: 'ok', text: 'In review' },
151
+ pending: {
152
+ changeRequestNumber: s.changeRequestNumber,
153
+ branch: s.branch,
154
+ authorName: s.authorName,
155
+ mine: s.isAuthor,
156
+ },
157
+ }));
158
+ const toolItems: LibraryItem[] = data.tools.map((t) => ({
159
+ kind: 'integration',
160
+ id: t.slug,
161
+ name: t.name,
162
+ // The browser tool surface exposes no human description for a `.tool`
163
+ // manual yet (see report) — the card stays clean; detail lives behind it.
164
+ description: '',
165
+ owned: t.canWrite,
166
+ group: displayGroupOf(t.path),
167
+ path: t.path,
168
+ status: toolStatus(t),
169
+ }));
170
+ return [...skillItems, ...pendingItems, ...toolItems];
171
+ }, [
172
+ data.skills,
173
+ data.pendingSkills,
174
+ data.tools,
175
+ data.ownedSkills,
176
+ data.allowedToolsBySkill,
177
+ ]);
178
+
179
+ // The loading flag is raised HERE rather than in the effect: `useState(true)`
180
+ // already covers the first load, and flipping it from the event that asked
181
+ // for the refetch keeps the effect body free of synchronous setState (which
182
+ // costs a cascading render on every revision).
183
+ const reloadGroups = useCallback(() => {
184
+ setGroupsLoading(true);
185
+ setGroupsRevision((r) => r + 1);
186
+ }, []);
187
+
188
+ const value = useMemo(
189
+ (): LibraryContextValue => ({
190
+ ...data,
191
+ items,
192
+ groupSummaries,
193
+ groupsLoading,
194
+ groupsError,
195
+ reloadGroups,
196
+ }),
197
+ [data, items, groupSummaries, groupsLoading, groupsError, reloadGroups],
198
+ );
199
+
200
+ return <LibraryContext.Provider value={value}>{children}</LibraryContext.Provider>;
201
+ }
202
+
203
+ export function useLibrary(): LibraryContextValue {
204
+ const value = useContext(LibraryContext);
205
+ if (!value) throw new Error('useLibrary must be used inside a LibraryProvider');
206
+ return value;
207
+ }
208
+
209
+ /**
210
+ * How many of a group's integrations need setup — the amber count on the
211
+ * sidebar row and the group page's banner, computed from one place so the two
212
+ * can never disagree.
213
+ *
214
+ * Only integrations count. A skill that reports `warn` is warning about the
215
+ * very integration already counted here, so counting both would double every
216
+ * broken connection; pending change requests are a review concern, not a setup
217
+ * one, and belong to a different surface.
218
+ */
219
+ export function attentionOf(items: LibraryItem[], group: string): number {
220
+ return items.filter(
221
+ (i) => i.group === group && i.kind === 'integration' && i.status.state !== 'ok',
222
+ ).length;
223
+ }
@@ -0,0 +1,32 @@
1
+ import { createContext, useContext } from 'react';
2
+
3
+ /**
4
+ * The toast channel, split out from the provider that renders it.
5
+ *
6
+ * Nothing here is a component, and that is the whole point: a module that
7
+ * exports a component AND a plain function can't be hot-swapped, so an edit
8
+ * to the toast markup would full-reload the app instead of Fast Refreshing it
9
+ * (`react-refresh/only-export-components`). Same split as
10
+ * `open-change-requests.context.ts` / `.tsx` and the other `*.context.ts`
11
+ * modules.
12
+ *
13
+ * The provider lives in `./toast.tsx`.
14
+ */
15
+
16
+ /** Neutral is the default: the message already says what happened. `danger`
17
+ * exists because half of these are failures, and a failure that renders
18
+ * identically to a confirmation is worse than no colour at all. */
19
+ export type ToastTone = 'neutral' | 'ok' | 'danger';
20
+
21
+ export type ShowToast = (msg: string, tone?: ToastTone) => void;
22
+
23
+ /**
24
+ * The default is a no-op rather than a throw (unchanged from when this lived
25
+ * in `toast.tsx`): a toast is advisory feedback, so a consumer rendered
26
+ * outside the provider should drop the message, not crash the tree.
27
+ */
28
+ export const ToastContext = createContext<ShowToast>(() => {});
29
+
30
+ export function useLibraryToast(): ShowToast {
31
+ return useContext(ToastContext);
32
+ }
@@ -1,42 +1,84 @@
1
- import {
2
- createContext,
3
- useCallback,
4
- useContext,
5
- useRef,
6
- useState,
7
- type ReactNode,
8
- } from 'react';
9
-
10
- /** Bottom-center toast from the approved mock — one line, auto-dismissing. */
11
-
12
- const ToastContext = createContext<(msg: string) => void>(() => {});
13
-
14
- export function useLibraryToast(): (msg: string) => void {
15
- return useContext(ToastContext);
16
- }
17
-
18
- export function LibraryToastProvider({ children }: { children: ReactNode }) {
19
- const [message, setMessage] = useState<string | null>(null);
20
- const timer = useRef<ReturnType<typeof setTimeout> | null>(null);
21
-
22
- const show = useCallback((msg: string) => {
23
- setMessage(msg);
24
- if (timer.current) clearTimeout(timer.current);
25
- timer.current = setTimeout(() => setMessage(null), 2600);
26
- }, []);
27
-
28
- return (
29
- <ToastContext.Provider value={show}>
30
- {children}
31
- <div
32
- role="status"
33
- aria-live="polite"
34
- className={`fixed left-1/2 bottom-6 -translate-x-1/2 z-[80] pointer-events-none rounded-xl border border-[#7fd0c4] bg-white px-5 py-2.5 text-[12.5px] font-semibold text-[#0f766e] shadow-[0_10px_30px_rgba(22,35,58,0.18)] transition-transform duration-300 ${
35
- message ? 'translate-y-0' : 'translate-y-24'
36
- }`}
37
- >
38
- {message}
39
- </div>
40
- </ToastContext.Provider>
41
- );
42
- }
1
+ import { useCallback, useRef, useState, type ReactNode } from 'react';
2
+ import { cn } from '../../../lib/utils';
3
+ import { toastDuration } from '../utils/toast-duration';
4
+ import { ToastContext, type ShowToast, type ToastTone } from './toast.context';
5
+
6
+ /**
7
+ * Bottom-center toast — the prototype's `#toast` (proto:719).
8
+ *
9
+ * An INK pill: dark plate, canvas text, fully round, no border and no shadow.
10
+ * It was a teal-on-white card built from four raw hex values left over from a
11
+ * retired mock, which made the one element that appears over every screen the
12
+ * one element belonging to no theme. The prototype's answer is better and
13
+ * simpler — the only inverted surface in the app, so it reads as the app
14
+ * speaking rather than as a panel that wandered in.
15
+ *
16
+ * Tone colours the PLATE, not the text. That is the opposite of `Banner`
17
+ * (`bg-*-soft text-*`) and it is forced by the inversion: `--color-ok` on
18
+ * `--color-ink` is a 2.4:1 contrast ratio and `--color-danger` on it is
19
+ * 1.9:1, so tone-as-text is unreadable here however well it works on a light
20
+ * surface. Against canvas text the three plates run 12.3:1 (ink), 5.1:1 (ok)
21
+ * and 6.5:1 (danger) — all clear of 4.5:1 — and the pill stays one inverted
22
+ * shape across every tone instead of flipping to a light card for errors.
23
+ *
24
+ * The channel itself — `ToastContext` and `useLibraryToast` — lives in
25
+ * `./toast.context.ts` so this module exports nothing but the component;
26
+ * `utils/toast-duration.ts` is split out for the same fast-refresh reason.
27
+ */
28
+
29
+ /** Kept next to the markup that consumes it rather than in the context
30
+ * module, because which plate a tone maps to is a rendering detail. */
31
+ const TONE: Record<ToastTone, string> = {
32
+ neutral: 'bg-ink',
33
+ ok: 'bg-ok',
34
+ danger: 'bg-danger',
35
+ };
36
+
37
+ export function LibraryToastProvider({ children }: { children: ReactNode }) {
38
+ // `visible` rather than dropping the toast to null on expiry: the element
39
+ // stays mounted so the exit animates, so its tone has to outlive the message.
40
+ const [toast, setToast] = useState<{
41
+ message: string;
42
+ tone: ToastTone;
43
+ visible: boolean;
44
+ } | null>(null);
45
+ const timer = useRef<ReturnType<typeof setTimeout> | null>(null);
46
+
47
+ const show = useCallback<ShowToast>((msg, tone = 'neutral') => {
48
+ setToast({ message: msg, tone, visible: true });
49
+ if (timer.current) clearTimeout(timer.current);
50
+ timer.current = setTimeout(
51
+ () => setToast((prev) => (prev ? { ...prev, visible: false } : null)),
52
+ toastDuration(msg),
53
+ );
54
+ }, []);
55
+
56
+ return (
57
+ <ToastContext.Provider value={show}>
58
+ {children}
59
+ <div
60
+ role="status"
61
+ aria-live="polite"
62
+ className={cn(
63
+ 'pointer-events-none fixed bottom-7 left-1/2 z-[80] -translate-x-1/2',
64
+ 'max-w-[82vw] rounded-full px-[18px] py-2.5',
65
+ 'text-center text-ui font-medium text-canvas',
66
+ // Read from the toast on its way out, not reset to neutral. The
67
+ // transition covers opacity and transform but NOT background-color,
68
+ // so dropping the tone on expiry would snap a danger toast from red
69
+ // to ink the instant it starts leaving — a jump, not a fade.
70
+ TONE[toast?.tone ?? 'neutral'],
71
+ // Opacity AND an 8px lift, as the prototype does: a pill that only
72
+ // slid would be readable while it was still arriving.
73
+ 'transition-[opacity,transform] duration-200 ease-out',
74
+ toast?.visible ? 'translate-y-0 opacity-100' : 'translate-y-2 opacity-0',
75
+ )}
76
+ >
77
+ {/* Cleared on expiry even though the plate lingers: the pill is only
78
+ transparent, not unmounted, so a stale message would stay readable
79
+ to a screen reader long after it left the screen. */}
80
+ {toast?.visible ? toast.message : null}
81
+ </div>
82
+ </ToastContext.Provider>
83
+ );
84
+ }
@@ -0,0 +1,33 @@
1
+ /**
2
+ * Copy text, and say whether it landed.
3
+ *
4
+ * `navigator.clipboard` is undefined outside a secure context (plain-HTTP
5
+ * staging, some embedded webviews), and `writeText` rejects when the document
6
+ * isn't focused. Both are ordinary conditions here, not exceptions — the
7
+ * Library's copy buttons hand over an agent prompt the user can also just
8
+ * select, so a failure has a real answer ("select the text instead") and must
9
+ * never surface as a success toast.
10
+ */
11
+ export async function copyToClipboard(text: string): Promise<boolean> {
12
+ const clipboard = navigator.clipboard;
13
+ if (!clipboard?.writeText) return false;
14
+ try {
15
+ await clipboard.writeText(text);
16
+ return true;
17
+ } catch {
18
+ return false;
19
+ }
20
+ }
21
+
22
+ /** What a copy button tells the user, either way. */
23
+ export const COPIED_TOAST = 'Prompt copied.';
24
+ export const COPY_FAILED_TOAST = "Couldn't copy: select the prompt text instead.";
25
+
26
+ /**
27
+ * The same pair for a LINK — the sidebar's `Copy link`. Separate strings
28
+ * because the recovery differs: a prompt is on screen to be selected by hand,
29
+ * a link to a row you are not standing on is not, so the honest advice is to
30
+ * open the row and copy from the address bar.
31
+ */
32
+ export const LINK_COPIED_TOAST = 'Link copied.';
33
+ export const LINK_COPY_FAILED_TOAST = "Couldn't copy: open the row and copy its address.";
@@ -0,0 +1,68 @@
1
+ import type { GroupPrincipals, GroupSummary } from '../services/groups.api';
2
+
3
+ /**
4
+ * How a group describes its membership in prose.
5
+ *
6
+ * Membership is displayed as ACCESS-RULE PRINCIPALS — the roles and people
7
+ * `access.md` names — and never as a head-count of who can read the folder.
8
+ * Three reasons, all load-bearing:
9
+ *
10
+ * 1. Expanding a role to its people needs the roster endpoint, which is
11
+ * admin-gated. A per-person list would render for admins and vanish for
12
+ * everyone else, so the same group would describe itself differently
13
+ * depending on who asked.
14
+ * 2. Resolution is closeness-first with per-file overrides, so "who can read
15
+ * this folder" is not well-defined AT folder granularity. A person list
16
+ * would be false precision.
17
+ * 3. These are the stored truth, and they are what `ManageAccessDialog` shows
18
+ * the moment a writer opens it — the two surfaces can never disagree.
19
+ *
20
+ * Consequence, accepted and permanent: no "{n} people" anywhere in the Library.
21
+ */
22
+
23
+ /** Names as written, users before roles — the order the run-by line reads in. */
24
+ function usersThenRoles(p: GroupPrincipals): string[] {
25
+ return [...p.users.map((u) => u.name), ...p.roles].filter((s) => s.length > 0);
26
+ }
27
+
28
+ /** Roles before people — the order a share list reads in. */
29
+ function rolesThenUsers(p: GroupPrincipals): string[] {
30
+ return [...p.roles, ...p.users.map((u) => u.name)].filter((s) => s.length > 0);
31
+ }
32
+
33
+ /**
34
+ * Who runs the group: owners, falling back to writers, falling back to the
35
+ * admins.
36
+ *
37
+ * The writer fallback is not a guess — owner ⊂ writer, and "who runs it" is
38
+ * really "who can change it". The final fallback is a fact rather than a
39
+ * placeholder: admin-rescue guarantees a platform Admin can always write an
40
+ * `access.md`, so a group with no named principals genuinely is run by them.
41
+ */
42
+ export function ownersTextOf(summary: Pick<GroupSummary, 'owners' | 'writers'>): string {
43
+ const owners = usersThenRoles(summary.owners);
44
+ if (owners.length > 0) return owners.join(', ');
45
+ const writers = usersThenRoles(summary.writers);
46
+ if (writers.length > 0) return writers.join(', ');
47
+ return 'the workspace admins';
48
+ }
49
+
50
+ /**
51
+ * Who the group is shared with, or `null` when there is nothing honest to say
52
+ * — either the reader list was withheld (the caller cannot read the group, and
53
+ * a locked group never advertises its share list) or it resolved empty.
54
+ * Callers drop the whole `· shared with …` clause on null rather than printing
55
+ * a dangling half-sentence.
56
+ */
57
+ export function readersTextOf(summary: Pick<GroupSummary, 'readers'>): string | null {
58
+ const readers = summary.readers;
59
+ if (!readers) return null;
60
+ if (!readers.restricted) return 'everyone here';
61
+ const named = rolesThenUsers(readers);
62
+ return named.length > 0 ? named.join(', ') : null;
63
+ }
64
+
65
+ /** The folder a group's writes and links point at — its single `Groups/<G>` folder. */
66
+ export function primaryFolderOf(summary: Pick<GroupSummary, 'folders'>): string | null {
67
+ return summary.folders[0] ?? null;
68
+ }
@@ -0,0 +1,30 @@
1
+ /**
2
+ * Rendering people's names the way a person says them.
3
+ *
4
+ * Shared by the locked-group view (its request toast) and the owner-side
5
+ * access-requests banner: both list requesters, and two copies of this drifted
6
+ * into place once already.
7
+ */
8
+
9
+ /**
10
+ * `A`, `A and B`, `A, B and C` — the way a person lists people out loud.
11
+ *
12
+ * The run-by lede uses `ownersTextOf`'s plainer comma join instead, because
13
+ * that line is a label the whole Library shares and this is a sentence spoken
14
+ * once.
15
+ */
16
+ export function joinNames(names: string[]): string {
17
+ if (names.length <= 1) return names[0] ?? '';
18
+ return `${names.slice(0, -1).join(', ')} and ${names[names.length - 1]}`;
19
+ }
20
+
21
+ /**
22
+ * First whitespace token of each name — "Olga Ivanova" → "Olga".
23
+ *
24
+ * For confirmations, not records: "Asked Olga" is how the person who just
25
+ * clicked would say it. Role names ("GTM Team" → "GTM") survive this the same
26
+ * way, which reads oddly but never wrongly.
27
+ */
28
+ export function firstNames(names: string[]): string[] {
29
+ return names.map((n) => n.trim().split(/\s+/)[0] ?? n).filter((n) => n.length > 0);
30
+ }
@@ -0,0 +1,15 @@
1
+ /**
2
+ * Leave the SPA for an absolute URL — the OAuth provider's authorization page.
3
+ *
4
+ * A one-line module rather than an inline `window.location.href = url`, for one
5
+ * reason: happy-dom treats a location assignment as a real navigation, so a
6
+ * test that exercises the sign-in path either warns or blows up. Behind a
7
+ * module boundary the whole thing is one `vi.mock` away, and the assertion
8
+ * becomes "we sent the user to the URL the server gave us" instead of "we
9
+ * poked window.location".
10
+ *
11
+ * Never call this with a path — `navigate()` from react-router owns those.
12
+ */
13
+ export function navigateExternal(url: string): void {
14
+ window.location.href = url;
15
+ }
@@ -0,0 +1,32 @@
1
+ /**
2
+ * The OAuth-callback outcome carried in the URL fragment.
3
+ *
4
+ * The backend callback redirects the browser to
5
+ * `<returnTo>#authorized=<id>` or `<returnTo>#error=<message>`; whichever page
6
+ * asked for the sign-in is the page that has to read it.
7
+ *
8
+ * Two rules make this correct, and both are easy to get wrong:
9
+ *
10
+ * 1. Read it ONCE, SYNCHRONOUSLY — `useState(readOAuthFragment)`, never an
11
+ * effect. The page also strips the fragment in an effect, and effects run
12
+ * in mount order, so a read-in-an-effect races the stripper and loses.
13
+ * 2. `URLSearchParams` already percent-decodes. A second `decodeURIComponent`
14
+ * corrupts any message containing a literal `%`, which is exactly what a
15
+ * provider error string tends to contain.
16
+ */
17
+
18
+ export type OAuthFragmentOutcome =
19
+ | { kind: 'authorized' }
20
+ | { kind: 'error'; message: string }
21
+ | null;
22
+
23
+ export function readOAuthFragment(): OAuthFragmentOutcome {
24
+ const hash = window.location.hash.replace(/^#/, '');
25
+ if (!hash) return null;
26
+ const params = new URLSearchParams(hash);
27
+ if (params.has('authorized')) return { kind: 'authorized' };
28
+ if (params.has('error')) {
29
+ return { kind: 'error', message: params.get('error') || 'Authorization failed.' };
30
+ }
31
+ return null;
32
+ }
@@ -0,0 +1,36 @@
1
+ /**
2
+ * The name of a person's own space — the prototype's `MINE()` (line 2078),
3
+ * which reads `me().name.split(' ')[0] + "'s List"`.
4
+ *
5
+ * It is called a GROUP here rather than a list because that is what it now is:
6
+ * the same page, the same sections, the same card grid as `Groups/Engineering`.
7
+ * The only difference is which items it holds, and that is a query, not a kind.
8
+ *
9
+ * First name only, deliberately. "Juan's Group" is what a colleague would call
10
+ * it out loud; "Juan Viera's Group" is what a directory would call it.
11
+ */
12
+ export function personalGroupName(displayName: string | null | undefined): string {
13
+ const first = displayFirstName(displayName);
14
+ // Nobody signed in, or a user record with no name: the space still exists and
15
+ // still needs a heading, and "Yours" is true for whoever is reading it.
16
+ if (!first) return 'Yours';
17
+ return `${first}'s Group`;
18
+ }
19
+
20
+ /**
21
+ * A person's first name, capitalized for display: `juan viera` → `Juan`.
22
+ *
23
+ * Sign-in records are not a style guide — an account created from a lowercase
24
+ * email or a hastily typed name should still be greeted the way a person
25
+ * writes their own name. The capital belongs HERE rather than at each call
26
+ * site, so the welcome page and the group heading cannot disagree about how
27
+ * to spell the same person.
28
+ *
29
+ * Empty when there is no name to work with, and each caller picks its own
30
+ * fallback: the group heading says "Yours", the welcome page says "there".
31
+ */
32
+ export function displayFirstName(displayName: string | null | undefined): string {
33
+ const first = (displayName ?? '').trim().split(/\s+/)[0] ?? '';
34
+ if (!first) return '';
35
+ return `${first.charAt(0).toUpperCase()}${first.slice(1)}`;
36
+ }