@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
@@ -1,164 +1,291 @@
1
- import { DEFAULT_BRANCH, type PullRequestSummary } from '@bevel-software/platform-shared';
2
- import { authFetch } from '../../../lib/api';
3
- import { handleApiResponse } from '../../git/services/git.api';
4
- import { createBranch } from '../../git/services/git.api';
5
- import { getOrCreateWorkspace, readFile, writeFile } from '../../workspace/services/workspace.api';
6
- import { openChangeRequest } from '../../pr/services/pr-open.api';
7
- import { postPrComment } from '../../pr/services/pr-comments.api';
8
-
9
- /**
10
- * Library data access. Skills come from the browser skill routes
11
- * (`GET /api/skills`, `GET /api/skills/:name[?file=…]`) — the same
12
- * default-branch, per-user-`canRead`-filtered catalog the agent sees.
13
- * Change requests come from the workflow routes the pr module already talks
14
- * to. Integration (tool) data is NOT here — the Library reuses
15
- * `secrets-vault/services/tool-secrets.api.ts` directly.
16
- */
17
-
18
- /** The default-branch workspace id — derivable client-side (id = encodeURIComponent(branch)). */
19
- export const DEFAULT_WORKSPACE_ID = encodeURIComponent(DEFAULT_BRANCH);
20
-
21
- export interface LibrarySkillSummary {
22
- /** Canonical id = the skill's folder name (e.g. `rfi`). */
23
- name: string;
24
- description: string;
25
- version?: string;
26
- /** Repo-root-relative skill folder, e.g. `Skills/rfi`. */
27
- path: string;
28
- }
29
-
30
- export interface LibrarySkill extends LibrarySkillSummary {
31
- /** The SKILL.md markdown body. */
32
- body: string;
33
- allowedTools?: string[];
34
- /** Repo-root-relative bundled file paths (SKILL.md itself is not listed). */
35
- files: string[];
36
- }
37
-
38
- interface SkillFilePayload {
39
- name: string;
40
- file: string;
41
- path: string;
42
- content: string;
43
- }
44
-
45
- type GetSkillPayload =
46
- | { ok: true; kind: 'skill'; skill: LibrarySkill }
47
- | { ok: true; kind: 'file'; file: SkillFilePayload }
48
- | { ok: false; error: 'not_found' | 'forbidden' | 'invalid_file' };
49
-
50
- export async function listSkills(): Promise<LibrarySkillSummary[]> {
51
- const data = await handleApiResponse<{ skills: LibrarySkillSummary[] }>(
52
- await authFetch('/api/skills'),
53
- );
54
- return data.skills;
55
- }
56
-
57
- export async function getSkill(name: string): Promise<LibrarySkill> {
58
- const data = await handleApiResponse<GetSkillPayload>(
59
- await authFetch(`/api/skills/${encodeURIComponent(name)}`),
60
- );
61
- if (!data.ok || data.kind !== 'skill') throw new Error("Couldn't load this skill.");
62
- return data.skill;
63
- }
64
-
65
- /** Content of a bundled skill file. `file` is relative to the skill folder. */
66
- export async function getSkillFile(name: string, file: string): Promise<string> {
67
- const data = await handleApiResponse<GetSkillPayload>(
68
- await authFetch(`/api/skills/${encodeURIComponent(name)}?file=${encodeURIComponent(file)}`),
69
- );
70
- if (!data.ok || data.kind !== 'file') throw new Error("Couldn't load this file.");
71
- return data.file.content;
72
- }
73
-
74
- /** All open change requests (the Library filters them to a skill's folder). */
75
- export async function listOpenChangeRequests(): Promise<PullRequestSummary[]> {
76
- return handleApiResponse<PullRequestSummary[]>(
77
- await authFetch('/api/workflow/change-requests'),
78
- );
79
- }
80
-
81
- /** The caller's own change requests (any state; callers filter to open). */
82
- export async function listMyChangeRequests(): Promise<PullRequestSummary[]> {
83
- return handleApiResponse<PullRequestSummary[]>(
84
- await authFetch('/api/workflow/change-requests/mine'),
85
- );
86
- }
87
-
88
- /** Read a file from a branch's shared workspace (bootstraps the clone if needed). */
89
- export async function readFileOnBranch(branch: string, repoRelativePath: string): Promise<string> {
90
- const { workspace } = await getOrCreateWorkspace(branch);
91
- return readFile(workspace.id, `${workspace.kbDirName}/${repoRelativePath}`);
92
- }
93
-
94
- /** Keep only characters git branch segments accept; collapse the rest to '-'. */
95
- function branchSegment(raw: string): string {
96
- const cleaned = raw
97
- .toLowerCase()
98
- .replace(/[^a-z0-9._-]+/g, '-')
99
- .replace(/^[-.]+/, '')
100
- .replace(/[.]+$/, '');
101
- return cleaned || 'user';
102
- }
103
-
104
- /** The one suggestion branch per user per skill (see mocks/README.md — suggestions are git). */
105
- export function suggestionBranchFor(userEmail: string, skillName: string): string {
106
- return `suggestions/${branchSegment(userEmail.split('@')[0])}/${branchSegment(skillName)}`;
107
- }
108
-
109
- export interface SuggestChangeInput {
110
- skillName: string;
111
- /** Repo-root-relative path of the file being suggested on. */
112
- repoRelativePath: string;
113
- /** Exact text to replace (must occur in the branch's current file content). */
114
- find: string;
115
- replace: string;
116
- /** Optional "why" — lands in the change-request description / a comment. */
117
- note?: string;
118
- userEmail: string;
119
- userName: string;
120
- /** The caller's open suggestion change request for this skill, if any. */
121
- existingCr?: PullRequestSummary | null;
122
- }
123
-
124
- /**
125
- * The real suggest-a-change flow: commit the edit to the user's suggestion
126
- * branch (`suggestions/<user>/<skill>`, forked from the default branch) and
127
- * make sure an open change request against the default branch exists for it.
128
- * Save = share: `writeFile` on the branch workspace auto-commits and pushes,
129
- * so the suggestion is durable the moment this resolves.
130
- */
131
- export async function suggestChange(input: SuggestChangeInput): Promise<{ branch: string }> {
132
- const branch = input.existingCr?.branch ?? suggestionBranchFor(input.userEmail, input.skillName);
133
-
134
- if (!input.existingCr) {
135
- try {
136
- await createBranch(DEFAULT_WORKSPACE_ID, branch, DEFAULT_BRANCH);
137
- } catch {
138
- // Branch may already exist from an earlier (merged/cancelled) round —
139
- // reuse it; the change request below is what makes it reviewable again.
140
- }
141
- }
142
-
143
- const { workspace } = await getOrCreateWorkspace(branch);
144
- const wsPath = `${workspace.kbDirName}/${input.repoRelativePath}`;
145
- const current = await readFile(workspace.id, wsPath);
146
- if (!current.includes(input.find)) {
147
- throw new Error('Select a plain stretch of text to suggest on.');
148
- }
149
- await writeFile(workspace.id, wsPath, current.replace(input.find, input.replace));
150
-
151
- if (input.existingCr) {
152
- if (input.note) {
153
- await postPrComment(input.existingCr.number, { body: input.note });
154
- }
155
- } else {
156
- await openChangeRequest({
157
- sourceBranch: branch,
158
- targetBranch: DEFAULT_BRANCH,
159
- title: `Suggestions from ${input.userName} — ${input.skillName}`,
160
- description: input.note || undefined,
161
- });
162
- }
163
- return { branch };
164
- }
1
+ import { DEFAULT_BRANCH, GROUPS_DIR, type PullRequestSummary } from '@bevel-software/platform-shared';
2
+ import { authFetch } from '../../../lib/api';
3
+ import { handleApiResponse } from '../../git/services/git.api';
4
+ import { createBranch } from '../../git/services/git.api';
5
+ import { deleteFile, getOrCreateWorkspace, writeFile } from '../../workspace/services/workspace.api';
6
+ import { openChangeRequest } from '../../pr/services/pr-open.api';
7
+ import { postPrComment } from '../../pr/services/pr-comments.api';
8
+ import { branchSegment } from '../../change-requests/services/propose.api';
9
+ import { ensurePersonalGroup } from './groups.api';
10
+
11
+ /**
12
+ * Library data access. Skills come from the browser skill routes
13
+ * (`GET /api/skills`, `GET /api/skills/:name[?file=…]`) — the same
14
+ * default-branch, per-user-`canRead`-filtered catalog the agent sees.
15
+ * Change requests come from the workflow routes the pr module already talks
16
+ * to. Integration (tool) data is NOT here — the Library reuses
17
+ * `secrets-vault/services/tool-secrets.api.ts` directly.
18
+ */
19
+
20
+ /** The default-branch workspace id — derivable client-side (id = encodeURIComponent(branch)). */
21
+ /**
22
+ * The default branch's workspace id. A FUNCTION because the branch model is
23
+ * applied during boot from `/api/config`: a module-scope constant would capture
24
+ * the empty string that exists before it, and being exported would spread that
25
+ * snapshot to every importer.
26
+ */
27
+ export const defaultWorkspaceId = () => encodeURIComponent(DEFAULT_BRANCH);
28
+
29
+ export interface LibrarySkillSummary {
30
+ /** Canonical id = the skill's folder name (e.g. `rfi`). */
31
+ name: string;
32
+ description: string;
33
+ version?: string;
34
+ /** Repo-root-relative skill folder, e.g. `Groups/Everyone/rfi`. */
35
+ path: string;
36
+ }
37
+
38
+ export interface LibrarySkill extends LibrarySkillSummary {
39
+ /** The SKILL.md markdown body. */
40
+ body: string;
41
+ allowedTools?: string[];
42
+ /** Repo-root-relative bundled file paths (SKILL.md itself is not listed). */
43
+ files: string[];
44
+ }
45
+
46
+ /**
47
+ * A skill that exists only on an open change request's branch — proposed, and
48
+ * waiting on somebody to approve it. Separate from `LibrarySkillSummary`
49
+ * because it is not in the catalog: nothing loads it, nothing runs it, and it
50
+ * is visible only to its author and to whoever could approve it.
51
+ */
52
+ export interface PendingSkillSummary extends LibrarySkillSummary {
53
+ changeRequestNumber: number;
54
+ branch: string;
55
+ authorName: string;
56
+ createdAt: string;
57
+ /** True when the caller proposed it themselves. */
58
+ isAuthor: boolean;
59
+ }
60
+
61
+ interface SkillFilePayload {
62
+ name: string;
63
+ file: string;
64
+ path: string;
65
+ content: string;
66
+ }
67
+
68
+ type GetSkillPayload =
69
+ | { ok: true; kind: 'skill'; skill: LibrarySkill }
70
+ | { ok: true; kind: 'file'; file: SkillFilePayload }
71
+ | { ok: false; error: 'not_found' | 'forbidden' | 'invalid_file' };
72
+
73
+ export async function listSkills(): Promise<LibrarySkillSummary[]> {
74
+ const data = await handleApiResponse<{ skills: LibrarySkillSummary[] }>(
75
+ await authFetch('/api/skills'),
76
+ );
77
+ return data.skills;
78
+ }
79
+
80
+ export async function getSkill(name: string): Promise<LibrarySkill> {
81
+ const data = await handleApiResponse<GetSkillPayload>(
82
+ await authFetch(`/api/skills/${encodeURIComponent(name)}`),
83
+ );
84
+ if (!data.ok || data.kind !== 'skill') throw new Error("Couldn't load this skill.");
85
+ return data.skill;
86
+ }
87
+
88
+ /**
89
+ * Skills awaiting approval that the caller may see. The backend does the
90
+ * filtering — author or possible approver — so this is a plain read.
91
+ */
92
+ export async function listPendingSkills(): Promise<PendingSkillSummary[]> {
93
+ const data = await handleApiResponse<{ skills: PendingSkillSummary[] }>(
94
+ await authFetch('/api/skills/pending'),
95
+ );
96
+ // Guarded, not trusted: a backend BUILT BEFORE this route existed answers
97
+ // through `/skills/:name` with `{ok:false}` — a 200 whose shape is not this
98
+ // one. The review shelf degrading to empty is the right failure; `undefined`
99
+ // reaching the item mapper took the whole library down (blank page).
100
+ return Array.isArray(data.skills) ? data.skills : [];
101
+ }
102
+
103
+ /** Content of a bundled skill file. `file` is relative to the skill folder. */
104
+ export async function getSkillFile(name: string, file: string): Promise<string> {
105
+ const data = await handleApiResponse<GetSkillPayload>(
106
+ await authFetch(`/api/skills/${encodeURIComponent(name)}?file=${encodeURIComponent(file)}`),
107
+ );
108
+ if (!data.ok || data.kind !== 'file') throw new Error("Couldn't load this file.");
109
+ return data.file.content;
110
+ }
111
+
112
+ // The cross-surface change-request reads (listOpenChangeRequests,
113
+ // listMyChangeRequests, readFileOnBranch) and the Knowledge propose flow
114
+ // live in `modules/change-requests/services/` now — this file keeps only
115
+ // what is specific to the Library's catalog and the per-skill propose flow.
116
+
117
+ /** The one suggestion branch per user per skill (see mocks/README.md — suggestions are git). */
118
+ export function suggestionBranchFor(userEmail: string, skillName: string): string {
119
+ return `suggestions/${branchSegment(userEmail.split('@')[0])}/${branchSegment(skillName)}`;
120
+ }
121
+
122
+ export interface ProposeChangeInput {
123
+ skillName: string;
124
+ /** Repo-root-relative path of the file being proposed on. */
125
+ repoRelativePath: string;
126
+ /** The file's full new text — what the author typed in the editor. */
127
+ content: string;
128
+ /** Optional "why" — lands in the change-request description / a comment. */
129
+ note?: string;
130
+ userEmail: string;
131
+ userName: string;
132
+ /** The caller's open change request for this skill, if any. */
133
+ existingCr?: PullRequestSummary | null;
134
+ }
135
+
136
+ /**
137
+ * Propose a change: commit the new text to the author's suggestion branch
138
+ * (`suggestions/<user>/<skill>`, forked from the default branch) and make sure
139
+ * an open change request against the default branch exists for it.
140
+ *
141
+ * Save = share: `writeFile` on the branch workspace auto-commits and pushes, so
142
+ * the proposal is durable the moment this resolves — there is no local-only
143
+ * state that could be lost between here and the owner reading it.
144
+ *
145
+ * One branch and one change request PER PERSON PER SKILL, not per file: a
146
+ * proposal that rewrites a step and its example touches two files and is one
147
+ * decision, so it has to arrive as one thing to approve.
148
+ */
149
+ export async function proposeChange(
150
+ input: ProposeChangeInput,
151
+ ): Promise<{ branch: string; kbDirName: string }> {
152
+ const branch = input.existingCr?.branch ?? suggestionBranchFor(input.userEmail, input.skillName);
153
+
154
+ if (!input.existingCr) {
155
+ try {
156
+ await createBranch(defaultWorkspaceId(), branch, DEFAULT_BRANCH);
157
+ } catch {
158
+ // Branch may already exist from an earlier (merged/cancelled) round —
159
+ // reuse it; the change request below is what makes it reviewable again.
160
+ }
161
+ }
162
+
163
+ const { workspace } = await getOrCreateWorkspace(branch);
164
+ await writeFile(
165
+ workspace.id,
166
+ `${workspace.kbDirName}/${input.repoRelativePath}`,
167
+ input.content,
168
+ );
169
+
170
+ if (input.existingCr) {
171
+ if (input.note) {
172
+ await postPrComment(input.existingCr.number, { body: input.note });
173
+ }
174
+ } else {
175
+ await openChangeRequest({
176
+ sourceBranch: branch,
177
+ targetBranch: DEFAULT_BRANCH,
178
+ title: `Changes from ${input.userName}. ${input.skillName}`,
179
+ description: input.note || undefined,
180
+ });
181
+ }
182
+ return { branch, kbDirName: workspace.kbDirName };
183
+ }
184
+
185
+ /**
186
+ * What a brand-new SKILL.md contains: the frontmatter fence, an empty
187
+ * `description`, and nothing else.
188
+ *
189
+ * Not zero bytes, and the difference matters. The catalog reads a skill's
190
+ * description straight out of this frontmatter (`skills.service.ts`
191
+ * `parseSkillFrontmatter`), so a file with no fence at all lists as a card with
192
+ * a blank subtitle and no visible hint that a description is a thing it could
193
+ * have. The fence is the shape of the thing; the emptiness inside it is the
194
+ * point. The skill's NAME is deliberately not written here — identity falls
195
+ * back to the folder name, and two places to change a skill's name is one place
196
+ * too many.
197
+ */
198
+ export const EMPTY_SKILL_MD = '---\ndescription:\n---\n\n';
199
+
200
+ export type CreateSkillInput = {
201
+ /** The skill's name, which becomes its folder name. */
202
+ name: string;
203
+ userEmail: string;
204
+ userName: string;
205
+ } & (
206
+ | {
207
+ /** Repo-root-relative group folder the skill lands in — `Groups/GTM`. */
208
+ parentPath: string;
209
+ /** False (or unknown) routes the new file through a change request instead. */
210
+ canWrite: boolean;
211
+ }
212
+ | {
213
+ /**
214
+ * The skill is the caller's own: it lands in their personal folder
215
+ * (`Groups/personal-<id>/`), which the provisioning endpoint ensures —
216
+ * and commits — first. Always a direct write: the ensured folder's
217
+ * access.md names the caller as owner, so the write gate passes on its
218
+ * own, with no permission special-case anywhere.
219
+ */
220
+ personal: true;
221
+ }
222
+ );
223
+
224
+ export interface CreatedSkill {
225
+ /** Repo-root-relative path of the new `SKILL.md`. */
226
+ repoRelativePath: string;
227
+ /** Workspace-relative path — what the file route wants. */
228
+ workspacePath: string;
229
+ /** Where it landed: the default branch, or the author's suggestion branch. */
230
+ branch: string;
231
+ /** True when it went in directly; false when it arrived as a change request. */
232
+ direct: boolean;
233
+ }
234
+
235
+ /**
236
+ * Make a new, empty skill: `<parentPath>/<name>/SKILL.md`.
237
+ *
238
+ * The folder is not created separately — `writeFile` mkdir's the parents — so
239
+ * this is one round trip, and there is no window in which an empty skill folder
240
+ * exists without the file that makes it a skill.
241
+ *
242
+ * Where it lands depends on whether the caller may write the destination, which
243
+ * is the same fork the "add" dialogs already describe in words: an owner's skill
244
+ * goes straight onto the default branch, and everyone else's arrives on their
245
+ * suggestion branch with a change request open against it. Callers get `direct`
246
+ * back so they can say which of the two happened rather than guess.
247
+ */
248
+ export async function createEmptySkill(input: CreateSkillInput): Promise<CreatedSkill> {
249
+ const parentPath =
250
+ 'personal' in input
251
+ ? `${GROUPS_DIR}/${(await ensurePersonalGroup()).folder}`
252
+ : input.parentPath;
253
+ const repoRelativePath = `${parentPath}/${input.name}/SKILL.md`;
254
+
255
+ if (!('personal' in input) && !input.canWrite) {
256
+ const { branch, kbDirName } = await proposeChange({
257
+ skillName: input.name,
258
+ repoRelativePath,
259
+ content: EMPTY_SKILL_MD,
260
+ userEmail: input.userEmail,
261
+ userName: input.userName,
262
+ });
263
+ return {
264
+ repoRelativePath,
265
+ workspacePath: `${kbDirName}/${repoRelativePath}`,
266
+ branch,
267
+ direct: false,
268
+ };
269
+ }
270
+
271
+ const { workspace } = await getOrCreateWorkspace(DEFAULT_BRANCH);
272
+ const workspacePath = `${workspace.kbDirName}/${repoRelativePath}`;
273
+ // Exclusive create: the panel's collision check runs against a skill list
274
+ // that can be stale, so the backend must be the one to refuse a name that
275
+ // was claimed since — a plain write here would silently empty the existing
276
+ // SKILL.md. The 409 surfaces through the panel's normal error toast.
277
+ await writeFile(workspace.id, workspacePath, EMPTY_SKILL_MD, { ifAbsent: true });
278
+ return { repoRelativePath, workspacePath, branch: DEFAULT_BRANCH, direct: true };
279
+ }
280
+
281
+ /**
282
+ * Delete a skill folder or tool file from the default branch — the group
283
+ * manager's "remove from group". One call for both shapes: the backend's
284
+ * delete route recurses a folder into per-file lock+commit cycles, and every
285
+ * one of those locks runs the per-path ACL gate, so a caller who does not
286
+ * manage the group is refused by the same rule that governs editing it.
287
+ */
288
+ export async function removeLibraryItem(repoRelativePath: string): Promise<void> {
289
+ const { workspace } = await getOrCreateWorkspace(DEFAULT_BRANCH);
290
+ await deleteFile(workspace.id, `${workspace.kbDirName}/${repoRelativePath}`);
291
+ }
@@ -0,0 +1,60 @@
1
+ import { authFetch } from '../../../lib/api';
2
+
3
+ /**
4
+ * The browser tool-detail read (`GET /api/tools/:slug`) — the two human-facing
5
+ * fields the catalog listing has no use for.
6
+ *
7
+ * Deliberately NOT the same surface as `tool-secrets.api.ts`. That one answers
8
+ * "what does this person still owe this tool"; this one answers "what IS this
9
+ * tool". The tool page needs both, from two endpoints, with different failure
10
+ * postures: a secrets failure is a page error, a detail failure is a degraded
11
+ * page that still connects. Keeping them apart is what makes that possible.
12
+ *
13
+ * The wire carries the full summary (`variables`, `remote`, `setup`) too; the
14
+ * page reads those from the secrets surface instead, where they arrive with the
15
+ * caller's config status attached, so they are not mirrored here.
16
+ */
17
+
18
+ /** One thing an inline manual's embedded tool list says the assistant can do. */
19
+ export interface ToolCapability {
20
+ name: string;
21
+ description: string | null;
22
+ }
23
+
24
+ export interface ToolManualDetail {
25
+ slug: string;
26
+ name: string;
27
+ path: string;
28
+ type: 'inline' | 'http' | 'mcp';
29
+ /** The `.tool` frontmatter description, or null when the file declares none. */
30
+ description: string | null;
31
+ /**
32
+ * `[]` for every `http`/`mcp` manual — those resolve their tools at call time,
33
+ * which this endpoint deliberately does not do. Hide the section on
34
+ * EMPTINESS, never on `type`: an inline tool with no embedded tools is the
35
+ * same "nothing to show" as a remote one.
36
+ */
37
+ capabilities: ToolCapability[];
38
+ }
39
+
40
+ async function unwrap(res: Response, fallback: string): Promise<never> {
41
+ let message = fallback;
42
+ try {
43
+ const body = (await res.json()) as { error?: string };
44
+ if (body?.error) message = body.error;
45
+ } catch {
46
+ // non-JSON body — keep the fallback
47
+ }
48
+ throw new Error(message);
49
+ }
50
+
51
+ /**
52
+ * One readable tool by slug. A 404 means "no such tool, or not yours" — the
53
+ * backend keeps those indistinguishable on purpose, so callers must not try to
54
+ * tell them apart either.
55
+ */
56
+ export async function getToolDetail(slug: string): Promise<ToolManualDetail> {
57
+ const res = await authFetch(`/api/tools/${encodeURIComponent(slug)}`);
58
+ if (!res.ok) await unwrap(res, "Couldn't load this tool.");
59
+ return ((await res.json()) as { tool: ToolManualDetail }).tool;
60
+ }
@@ -0,0 +1,22 @@
1
+ import { createContext, useContext } from 'react';
2
+ import type { LibraryContextValue } from './library-data';
3
+
4
+ /**
5
+ * The library's context object and its provider-optional hooks, in a file of
6
+ * their own: `library-data.tsx` renders the provider COMPONENT, and fast
7
+ * refresh only preserves state for files that export components alone — every
8
+ * hook this module grows would otherwise cost the provider its hot reload.
9
+ * (`useLibrary`, which predates the split, still lives beside the provider.)
10
+ */
11
+ export const LibraryContext = createContext<LibraryContextValue | null>(null);
12
+
13
+ /**
14
+ * The catalog's reload signal, tolerating an absent provider. For leaf
15
+ * components (dialog panels) that only need to ANNOUNCE "the catalog
16
+ * changed" — outside a provider (component tests, future embeddings) the
17
+ * announcement has no audience, and that is fine.
18
+ */
19
+ export function useLibraryReload(): () => void {
20
+ const value = useContext(LibraryContext);
21
+ return value?.reload ?? (() => {});
22
+ }