@bevel-software/platform-core-frontend 0.15.1 → 0.20.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (347) hide show
  1. package/THIRD-PARTY-NOTICES.md +2 -2
  2. package/package.json +3 -3
  3. package/src/core/CoreAppShell.tsx +20 -9
  4. package/src/core/__tests__/AppChrome.test.tsx +0 -3
  5. package/src/core/__tests__/events.test.ts +43 -0
  6. package/src/core/bootstrap.ts +11 -3
  7. package/src/core/events.ts +85 -3
  8. package/src/core/registry.ts +1 -1
  9. package/src/lib/__tests__/email.test.ts +44 -0
  10. package/src/lib/email.ts +37 -1
  11. package/src/modules/access/__tests__/ManageAccessDialog.add-row-picking.test.tsx +141 -0
  12. package/src/modules/access/__tests__/ManageAccessDialog.chip-truncation.test.tsx +204 -0
  13. package/src/modules/access/__tests__/ManageAccessDialog.download-read.test.tsx +234 -0
  14. package/src/modules/access/__tests__/ManageAccessDialog.edited-row-visible.test.tsx +160 -0
  15. package/src/modules/access/__tests__/ManageAccessDialog.placement.test.tsx +2 -2
  16. package/src/modules/access/__tests__/ManageAccessDialog.proposal.test.tsx +166 -0
  17. package/src/modules/access/__tests__/ManageAccessDialog.restrict.test.tsx +510 -0
  18. package/src/modules/access/__tests__/ManageAccessDialog.row-menu-axes.test.tsx +299 -0
  19. package/src/modules/access/__tests__/ManageAccessDialog.row-menu-width.test.tsx +226 -0
  20. package/src/modules/access/__tests__/ManageAccessDialog.test.tsx +721 -126
  21. package/src/modules/access/__tests__/ManageAccessDialog.unknown-email.test.tsx +314 -0
  22. package/src/modules/access/__tests__/manage-access-affordance.test.ts +14 -0
  23. package/src/modules/access/__tests__/tailwindDeclarations.ts +210 -0
  24. package/src/modules/access/api.ts +140 -6
  25. package/src/modules/access/components/ManageAccessDialog.tsx +1299 -561
  26. package/src/modules/access/manage-access-affordance.ts +17 -0
  27. package/src/modules/admin/__tests__/AddMemberInput.test.tsx +297 -0
  28. package/src/modules/admin/__tests__/AdminRolesPage.capabilities.test.tsx +2 -2
  29. package/src/modules/admin/__tests__/AdminRolesPage.fixed-admin.test.tsx +189 -0
  30. package/src/modules/admin/__tests__/AdminRolesPage.suggest.test.tsx +1 -1
  31. package/src/modules/admin/__tests__/DirectoryGroupsPage.suggest.test.tsx +182 -0
  32. package/src/modules/admin/__tests__/DirectoryGroupsPage.test.tsx +165 -14
  33. package/src/modules/admin/__tests__/UserAccountsPage.test.tsx +401 -4
  34. package/src/modules/admin/__tests__/group-members-path.test.ts +27 -0
  35. package/src/modules/admin/components/AddMemberInput.tsx +268 -0
  36. package/src/modules/admin/components/AdminRolesPage.tsx +97 -132
  37. package/src/modules/admin/components/DirectoryGroupsPage.tsx +91 -39
  38. package/src/modules/admin/components/UserAccountsPage.tsx +271 -37
  39. package/src/modules/admin/components/group-members-path.ts +32 -0
  40. package/src/modules/admin/services/roles.api.ts +12 -1
  41. package/src/modules/audit/__tests__/AuditLogPage.test.tsx +312 -0
  42. package/src/modules/audit/components/AuditEventsPanel.tsx +319 -0
  43. package/src/modules/audit/components/AuditLogPage.tsx +373 -0
  44. package/src/modules/audit/components/principal-grouping.ts +49 -0
  45. package/src/modules/audit/services/audit.api.ts +98 -0
  46. package/src/modules/auth/__tests__/AccountPage.test.tsx +50 -2
  47. package/src/modules/auth/components/AccountPage.tsx +73 -54
  48. package/src/modules/auth/components/LoginScreen.tsx +1 -0
  49. package/src/modules/auth/services/account.api.ts +78 -4
  50. package/src/modules/change-requests/__tests__/ChangeRequestDialog.access-rules.test.tsx +144 -0
  51. package/src/modules/change-requests/__tests__/ChangeRequestDialog.binary.test.tsx +422 -0
  52. package/src/modules/change-requests/__tests__/ChangeRequestDialog.brings-itself-up-to-date.test.tsx +431 -0
  53. package/src/modules/change-requests/__tests__/ChangeRequestDialog.fork-point.test.tsx +193 -0
  54. package/src/modules/change-requests/__tests__/ChangeRequestDialog.initial-file.test.tsx +142 -0
  55. package/src/modules/change-requests/__tests__/ChangeRequestDialog.moved.test.tsx +202 -0
  56. package/src/modules/change-requests/__tests__/ChangeRequestDialog.test.tsx +205 -13
  57. package/src/modules/change-requests/__tests__/ChangeRequestDialog.unreadable.test.tsx +271 -0
  58. package/src/modules/change-requests/__tests__/FileChangeBoxes.test.tsx +208 -0
  59. package/src/modules/change-requests/__tests__/apply-outcome-for-every-viewer.test.tsx +286 -0
  60. package/src/modules/change-requests/__tests__/propose.concurrent.test.ts +273 -0
  61. package/src/modules/change-requests/__tests__/readFailure.test.ts +122 -0
  62. package/src/modules/change-requests/__tests__/useCrFileDiffs.test.tsx +238 -0
  63. package/src/modules/change-requests/__tests__/useFileOnBranch.test.tsx +56 -1
  64. package/src/modules/change-requests/__tests__/useForkPointFile.test.tsx +79 -0
  65. package/src/modules/change-requests/components/BranchFilePreview.tsx +357 -0
  66. package/src/modules/change-requests/components/ChangeBox.tsx +31 -2
  67. package/src/modules/change-requests/components/ChangeRequestDialog.tsx +862 -72
  68. package/src/modules/change-requests/components/CrFileTree.tsx +74 -58
  69. package/src/modules/change-requests/components/FileChangeBoxes.tsx +19 -15
  70. package/src/modules/change-requests/hooks/useApplyChangeRequest.ts +41 -7
  71. package/src/modules/change-requests/hooks/useCrFileDiffs.ts +181 -23
  72. package/src/modules/change-requests/hooks/useFileOnBranch.ts +70 -7
  73. package/src/modules/change-requests/hooks/useForkPointFile.ts +77 -0
  74. package/src/modules/change-requests/services/change-requests.api.ts +57 -1
  75. package/src/modules/change-requests/services/denied-file.api.ts +53 -0
  76. package/src/modules/change-requests/services/propose.api.ts +97 -8
  77. package/src/modules/change-requests/utils/approval.ts +15 -0
  78. package/src/modules/change-requests/utils/author.ts +32 -0
  79. package/src/modules/change-requests/utils/readFailure.ts +110 -0
  80. package/src/modules/git/__tests__/FileHistoryPanel.test.tsx +20 -0
  81. package/src/modules/git/components/FileHistoryPanel.tsx +5 -0
  82. package/src/modules/git/components/PullRequestsForMe.tsx +51 -24
  83. package/src/modules/git/services/__tests__/error-messages.test.ts +29 -0
  84. package/src/modules/git/services/error-messages.ts +12 -0
  85. package/src/modules/git/services/pr-prompts.ts +5 -5
  86. package/src/modules/layout/__tests__/HeaderAlignment.test.tsx +401 -0
  87. package/src/modules/layout/__tests__/SidebarFooterGrid.test.tsx +286 -0
  88. package/src/modules/layout/__tests__/SidebarFrameResponsive.test.tsx +61 -0
  89. package/src/modules/layout/components/AppLayout.tsx +2 -0
  90. package/src/modules/layout/components/MobileChatLayout.tsx +4 -1
  91. package/src/modules/layout/components/ResizableThreePaneLayout.tsx +4 -1
  92. package/src/modules/layout/components/SidebarFrame.tsx +108 -3
  93. package/src/modules/library/__tests__/AddToPluginDialog.test.tsx +171 -5
  94. package/src/modules/library/__tests__/DeleteToolDialog.test.tsx +356 -0
  95. package/src/modules/library/__tests__/IntegrationsSetupReminder.test.tsx +60 -0
  96. package/src/modules/library/__tests__/LibraryCard.test.tsx +91 -10
  97. package/src/modules/library/__tests__/LibraryRoutes.test.tsx +242 -107
  98. package/src/modules/library/__tests__/LibrarySidebarMenu.test.tsx +103 -98
  99. package/src/modules/library/__tests__/LinkSkillPanel.test.tsx +20 -5
  100. package/src/modules/library/__tests__/LockedPluginView.test.tsx +97 -7
  101. package/src/modules/library/__tests__/NewPluginDialog.test.tsx +13 -4
  102. package/src/modules/library/__tests__/PersonalAddDialog.test.tsx +79 -3
  103. package/src/modules/library/__tests__/PersonalPluginPage.test.tsx +201 -0
  104. package/src/modules/library/__tests__/PluginExtras.test.tsx +100 -9
  105. package/src/modules/library/__tests__/PluginJoinRequests.test.tsx +60 -1
  106. package/src/modules/library/__tests__/PluginPage.test.tsx +258 -6
  107. package/src/modules/library/__tests__/PluginsSidebar.contextmenu.test.tsx +16 -56
  108. package/src/modules/library/__tests__/PluginsSidebar.test.tsx +155 -152
  109. package/src/modules/library/__tests__/PluginsSidebarMenu.test.tsx +16 -0
  110. package/src/modules/library/__tests__/SharedViaPlugins.test.tsx +106 -0
  111. package/src/modules/library/__tests__/SkillPage.test.tsx +386 -80
  112. package/src/modules/library/__tests__/SkillsTree.test.tsx +293 -4
  113. package/src/modules/library/__tests__/ToolConnectionSection.test.tsx +582 -71
  114. package/src/modules/library/__tests__/ToolPage.test.tsx +87 -4
  115. package/src/modules/library/__tests__/WorkspaceItemRoute.test.tsx +173 -26
  116. package/src/modules/library/__tests__/auth-harness.tsx +9 -9
  117. package/src/modules/library/__tests__/card-row-menu.test.tsx +320 -0
  118. package/src/modules/library/__tests__/library-data.mapping.test.tsx +98 -0
  119. package/src/modules/library/__tests__/library-data.stale.test.tsx +121 -28
  120. package/src/modules/library/__tests__/library-data.test.ts +7 -0
  121. package/src/modules/library/__tests__/library-paths.test.ts +47 -4
  122. package/src/modules/library/__tests__/link-membership.test.ts +13 -4
  123. package/src/modules/library/__tests__/name-with-badges.test.tsx +273 -0
  124. package/src/modules/library/__tests__/newSkillMarkdown.test.ts +30 -0
  125. package/src/modules/library/__tests__/owner-pill.test.tsx +357 -0
  126. package/src/modules/library/__tests__/pending-tools.test.tsx +400 -0
  127. package/src/modules/library/__tests__/plugin-entries.test.ts +122 -0
  128. package/src/modules/library/__tests__/plugin-summary.test.ts +36 -1
  129. package/src/modules/library/__tests__/status.test.ts +82 -2
  130. package/src/modules/library/__tests__/tools.api.test.ts +44 -1
  131. package/src/modules/library/components/AccessRequestsBanner.tsx +85 -47
  132. package/src/modules/library/components/AddDialogTabs.tsx +103 -0
  133. package/src/modules/library/components/AddToPluginDialog.tsx +74 -18
  134. package/src/modules/library/components/IntegrationsSetupReminder.tsx +59 -0
  135. package/src/modules/library/components/ItemActionsMenu.tsx +288 -0
  136. package/src/modules/library/components/LibraryCard.tsx +146 -45
  137. package/src/modules/library/components/LibraryLayout.tsx +119 -256
  138. package/src/modules/library/components/LibraryPage.tsx +172 -39
  139. package/src/modules/library/components/LinkSkillPanel.tsx +1 -3
  140. package/src/modules/library/components/LockedPluginView.tsx +62 -34
  141. package/src/modules/library/components/NameWithBadges.tsx +164 -0
  142. package/src/modules/library/components/NewPluginDialog.tsx +16 -2
  143. package/src/modules/library/components/PageActions.tsx +11 -9
  144. package/src/modules/library/components/{PendingSkillReview.tsx → PendingItemReview.tsx} +14 -7
  145. package/src/modules/library/components/PersonalAddDialog.tsx +68 -18
  146. package/src/modules/library/components/PersonalPluginPage.tsx +121 -22
  147. package/src/modules/library/components/PluginExtras.tsx +140 -17
  148. package/src/modules/library/components/PluginIndexRow.tsx +47 -12
  149. package/src/modules/library/components/PluginPage.tsx +157 -41
  150. package/src/modules/library/components/PluginRows.tsx +286 -0
  151. package/src/modules/library/components/PluginsSidebar.tsx +239 -263
  152. package/src/modules/library/components/PluginsSidebarMenu.tsx +26 -1
  153. package/src/modules/library/components/ShareButton.tsx +17 -0
  154. package/src/modules/library/components/SkillsTree.tsx +141 -28
  155. package/src/modules/library/components/TeamRoute.tsx +15 -0
  156. package/src/modules/library/components/__tests__/upload-notices-once-per-page.test.tsx +144 -0
  157. package/src/modules/library/components/plugin-page-parts.tsx +103 -17
  158. package/src/modules/library/components/skill-page/SharedViaPlugins.tsx +6 -12
  159. package/src/modules/library/components/skill-page/SkillFilePane.tsx +5 -0
  160. package/src/modules/library/components/skill-page/SkillPage.tsx +274 -122
  161. package/src/modules/library/components/tool-page/DeleteToolDialog.tsx +218 -0
  162. package/src/modules/library/components/tool-page/ToolConnectionSection.tsx +79 -178
  163. package/src/modules/library/components/tool-page/ToolPage.tsx +106 -16
  164. package/src/modules/library/components/tool-page/ToolVarRow.tsx +42 -41
  165. package/src/modules/library/hooks/__tests__/useLibraryData.test.ts +98 -0
  166. package/src/modules/library/hooks/useLibraryData.ts +92 -19
  167. package/src/modules/library/routes/LibraryRoutes.tsx +14 -11
  168. package/src/modules/library/routes/WorkspaceItemRoute.tsx +77 -27
  169. package/src/modules/library/routes/library-paths.ts +26 -28
  170. package/src/modules/library/services/library.api.ts +38 -20
  171. package/src/modules/library/services/plugins.api.ts +69 -8
  172. package/src/modules/library/services/teams.api.ts +15 -0
  173. package/src/modules/library/services/tools.api.ts +78 -0
  174. package/src/modules/library/state/library-data.tsx +170 -32
  175. package/src/modules/library/utils/personal-plugin.ts +13 -15
  176. package/src/modules/library/utils/plugin-entries.ts +134 -0
  177. package/src/modules/library/utils/plugin-summary.ts +75 -9
  178. package/src/modules/library/utils/status.ts +135 -33
  179. package/src/modules/onboarding/__tests__/creator-welcome.test.tsx +8 -1
  180. package/src/modules/onboarding/__tests__/onboarding.test.tsx +853 -760
  181. package/src/modules/onboarding/agent-clients.ts +55 -23
  182. package/src/modules/onboarding/components/ConnectAgentPill.tsx +5 -1
  183. package/src/modules/onboarding/components/WelcomePage.tsx +98 -62
  184. package/src/modules/pr/services/pr-merge.api.ts +2 -1
  185. package/src/modules/review/components/MarkdownDiffViewer.tsx +53 -8
  186. package/src/modules/review/components/ReviewPanel.tsx +15 -17
  187. package/src/modules/review/components/__tests__/MarkdownDiffViewer.test.tsx +64 -0
  188. package/src/modules/review/components/__tests__/ReviewPanel.test.tsx +25 -1
  189. package/src/modules/secrets-vault/components/ConnectToolsPage.tsx +454 -117
  190. package/src/modules/secrets-vault/components/SecretsPage.tsx +48 -7
  191. package/src/modules/secrets-vault/components/ToolSecretsPanel.tsx +84 -5
  192. package/src/modules/secrets-vault/components/__tests__/ConnectToolsPage.test.tsx +425 -0
  193. package/src/modules/secrets-vault/components/__tests__/SecretsPage.test.tsx +417 -82
  194. package/src/modules/secrets-vault/components/__tests__/ToolSecretsPanel.test.tsx +105 -0
  195. package/src/modules/secrets-vault/components/__tests__/connect-lists-what-the-banner-counted.test.tsx +407 -0
  196. package/src/modules/secrets-vault/probe/SavedKeyProbeResult.tsx +98 -0
  197. package/src/modules/secrets-vault/probe/__tests__/probe-verdict.test.ts +160 -0
  198. package/src/modules/secrets-vault/probe/probe-verdict.ts +108 -0
  199. package/src/modules/secrets-vault/probe/useSavedKeyProbe.ts +228 -0
  200. package/src/modules/secrets-vault/services/connect.api.ts +36 -5
  201. package/src/modules/secrets-vault/utils/connect-status.ts +98 -0
  202. package/src/modules/settings/components/ClaudeConnectionCard.tsx +9 -24
  203. package/src/modules/settings/components/ClaudeConnectionFields.tsx +23 -0
  204. package/src/modules/settings/components/DeploymentPage.tsx +10 -30
  205. package/src/modules/settings/components/MarketplaceSection.tsx +152 -0
  206. package/src/modules/settings/components/__tests__/DeploymentPage.test.tsx +67 -4
  207. package/src/modules/settings/components/__tests__/MarketplaceSection.test.tsx +325 -0
  208. package/src/modules/settings/components/__tests__/SettingsLayout.test.tsx +7 -6
  209. package/src/modules/settings/services/github-facade.api.ts +23 -0
  210. package/src/modules/settings/settings-nav-items.tsx +13 -3
  211. package/src/modules/setup/__tests__/setup.oidc.test.tsx +172 -0
  212. package/src/modules/setup/__tests__/setup.probe-refusal.test.tsx +123 -0
  213. package/src/modules/setup/__tests__/setup.test.tsx +497 -4
  214. package/src/modules/setup/__tests__/useSetupStatus.test.tsx +130 -0
  215. package/src/modules/setup/components/SetupGate.tsx +16 -16
  216. package/src/modules/setup/components/SetupScreen.tsx +532 -43
  217. package/src/modules/setup/hooks/useSetupStatus.ts +93 -0
  218. package/src/modules/setup/services/setup.api.ts +141 -4
  219. package/src/modules/setup/utils/__tests__/root-folders.test.ts +72 -0
  220. package/src/modules/setup/utils/root-folders.ts +46 -0
  221. package/src/modules/toolbar/assets/claude-setup/01-add-manually.webp +0 -0
  222. package/src/modules/toolbar/assets/claude-setup/02-add-configuration.webp +0 -0
  223. package/src/modules/toolbar/assets/claude-setup/03-connect-account.webp +0 -0
  224. package/src/modules/toolbar/assets/claude-setup/04-pick-instance.webp +0 -0
  225. package/src/modules/toolbar/assets/claude-setup/05-plugins-add.webp +0 -0
  226. package/src/modules/toolbar/assets/claude-setup/06-add-marketplace.webp +0 -0
  227. package/src/modules/toolbar/assets/claude-setup/07-paste-url-sync.webp +0 -0
  228. package/src/modules/toolbar/assets/claude-setup/08-install-plugins.webp +0 -0
  229. package/src/modules/toolbar/assets/claude-setup/09-select-repository.webp +0 -0
  230. package/src/modules/toolbar/assets/claude-setup/10-connector-not-added.webp +0 -0
  231. package/src/modules/toolbar/assets/claude-setup/11-add-custom-connector.webp +0 -0
  232. package/src/modules/toolbar/assets/claude-setup/README.md +68 -0
  233. package/src/modules/toolbar/components/AgentInstructionsCard.tsx +296 -0
  234. package/src/modules/toolbar/components/ClaudeMarketplaceCarousel.tsx +107 -0
  235. package/src/modules/toolbar/components/ClaudeRegistrationSteps.tsx +127 -0
  236. package/src/modules/toolbar/components/CoworkSetupSteps.tsx +100 -0
  237. package/src/modules/toolbar/components/ExternalAgentAccessPage.tsx +177 -118
  238. package/src/modules/toolbar/components/ScreenshotStep.tsx +77 -0
  239. package/src/modules/toolbar/components/SetupCarousel.tsx +177 -0
  240. package/src/modules/toolbar/components/__tests__/AgentInstructionsCard.test.tsx +370 -0
  241. package/src/modules/toolbar/components/__tests__/ExternalAgentAccessPage.test.tsx +542 -42
  242. package/src/modules/toolbar/components/__tests__/Toolbar.test.tsx +2 -2
  243. package/src/modules/toolbar/components/__tests__/claude-setup-shots.test.ts +104 -0
  244. package/src/modules/toolbar/components/claude-connector-slide.tsx +38 -0
  245. package/src/modules/toolbar/components/claude-setup-shots.ts +167 -0
  246. package/src/modules/toolbar/components/deployment-address.ts +29 -0
  247. package/src/modules/toolbar/components/setup-step-parts.tsx +35 -0
  248. package/src/modules/toolbar/services/__tests__/agent-instructions.api.test.ts +89 -0
  249. package/src/modules/toolbar/services/agent-instructions.api.ts +167 -0
  250. package/src/modules/toolbar/services/external-api-keys.api.ts +8 -0
  251. package/src/modules/workflow/state/ChangeRequestStaleBinder.tsx +43 -0
  252. package/src/modules/workflow/state/EventBusProvider.tsx +122 -11
  253. package/src/modules/workflow/state/__tests__/EventBusProvider.storage.test.tsx +87 -0
  254. package/src/modules/workflow/state/__tests__/EventBusProvider.watch.test.tsx +223 -0
  255. package/src/modules/workflow/state/event-bus.context.ts +10 -0
  256. package/src/modules/workspace/__tests__/testFixtures.ts +5 -3
  257. package/src/modules/workspace/components/FileExplorer.tsx +1295 -191
  258. package/src/modules/workspace/components/FileRoute.tsx +353 -36
  259. package/src/modules/workspace/components/FileViewer.tsx +172 -46
  260. package/src/modules/workspace/components/KbDocumentShell.tsx +50 -6
  261. package/src/modules/workspace/components/KbPageHeader.tsx +120 -55
  262. package/src/modules/workspace/components/TreeActionConfirm.tsx +350 -0
  263. package/src/modules/workspace/components/__tests__/FileExplorer.test.tsx +2533 -129
  264. package/src/modules/workspace/components/__tests__/FileRoute.test.tsx +731 -18
  265. package/src/modules/workspace/components/__tests__/FileViewer.test.tsx +381 -12
  266. package/src/modules/workspace/components/__tests__/KbDocumentShell.test.tsx +39 -0
  267. package/src/modules/workspace/components/__tests__/KbPageHeader.test.tsx +33 -20
  268. package/src/modules/workspace/components/renderers/DocxRenderer.tsx +4 -5
  269. package/src/modules/workspace/components/renderers/DownloadFileButton.tsx +13 -4
  270. package/src/modules/workspace/components/renderers/EmailRenderer.tsx +4 -3
  271. package/src/modules/workspace/components/renderers/HtmlRenderer.tsx +8 -14
  272. package/src/modules/workspace/components/renderers/ImageRenderer.tsx +75 -16
  273. package/src/modules/workspace/components/renderers/KbImage.tsx +180 -0
  274. package/src/modules/workspace/components/renderers/KbMarkdownView.tsx +22 -6
  275. package/src/modules/workspace/components/renderers/MarkdownRenderer.tsx +48 -22
  276. package/src/modules/workspace/components/renderers/PdfRenderer.tsx +4 -5
  277. package/src/modules/workspace/components/renderers/PptxRenderer.tsx +4 -3
  278. package/src/modules/workspace/components/renderers/XlsxRenderer.tsx +4 -3
  279. package/src/modules/workspace/components/renderers/__tests__/DocxRenderer.test.tsx +12 -0
  280. package/src/modules/workspace/components/renderers/__tests__/DownloadFileButton.test.tsx +57 -9
  281. package/src/modules/workspace/components/renderers/__tests__/EmailRenderer.test.tsx +13 -1
  282. package/src/modules/workspace/components/renderers/__tests__/ImageRenderer.test.tsx +163 -0
  283. package/src/modules/workspace/components/renderers/__tests__/KbMarkdownView.test.tsx +237 -0
  284. package/src/modules/workspace/components/renderers/__tests__/MarkdownRenderer.test.tsx +108 -14
  285. package/src/modules/workspace/components/renderers/__tests__/PptxRenderer.test.tsx +14 -1
  286. package/src/modules/workspace/components/renderers/__tests__/XlsxRenderer.test.tsx +16 -1
  287. package/src/modules/workspace/components/renderers/__tests__/rendererSelection.test.tsx +66 -1
  288. package/src/modules/workspace/components/renderers/index.ts +53 -2
  289. package/src/modules/workspace/components/renderers/kbMarkdownPipeline.tsx +25 -4
  290. package/src/modules/workspace/components/renderers/rendererWorkspace.ts +40 -0
  291. package/src/modules/workspace/hooks/__tests__/useImageRevision.test.tsx +174 -0
  292. package/src/modules/workspace/hooks/__tests__/useOpenChangeRequests.test.tsx +179 -1
  293. package/src/modules/workspace/hooks/__tests__/useWorkspaceImageResolver.test.tsx +122 -0
  294. package/src/modules/workspace/hooks/__tests__/useWorkspaceState.test.tsx +892 -7
  295. package/src/modules/workspace/hooks/useImageRevision.ts +101 -0
  296. package/src/modules/workspace/hooks/useMergedWorkspaceTree.ts +22 -3
  297. package/src/modules/workspace/hooks/useWorkspaceImageResolver.ts +55 -0
  298. package/src/modules/workspace/hooks/useWorkspaceState.ts +424 -66
  299. package/src/modules/workspace/routing/__tests__/kb-routes.test.tsx +279 -3
  300. package/src/modules/workspace/routing/kb-routes.ts +206 -29
  301. package/src/modules/workspace/services/__tests__/workspace.api.test.ts +134 -1
  302. package/src/modules/workspace/services/workspace.api.ts +57 -4
  303. package/src/modules/workspace/state/__tests__/applied-request-clears-pending.test.tsx +343 -0
  304. package/src/modules/workspace/state/__tests__/upload-lands-where-it-was-dropped.test.tsx +158 -0
  305. package/src/modules/workspace/state/open-change-requests.tsx +100 -12
  306. package/src/modules/workspace/state/workspace.context.ts +125 -19
  307. package/src/modules/workspace/utils/__tests__/file-trace.test.ts +73 -0
  308. package/src/modules/workspace/utils/__tests__/fileTree.test.ts +220 -6
  309. package/src/modules/workspace/utils/__tests__/pasteLink.test.ts +76 -0
  310. package/src/modules/workspace/utils/__tests__/treeConfirm.test.ts +364 -0
  311. package/src/modules/workspace/utils/__tests__/uploadError.test.ts +35 -0
  312. package/src/modules/workspace/utils/file-trace.ts +50 -0
  313. package/src/modules/workspace/utils/fileTree.ts +112 -36
  314. package/src/modules/workspace/utils/frontmatter.ts +8 -4
  315. package/src/modules/workspace/utils/pasteLink.ts +90 -0
  316. package/src/modules/workspace/utils/treeConfirm.ts +338 -0
  317. package/src/modules/workspace/utils/uploadError.ts +29 -0
  318. package/src/shared/__tests__/marketplace-url.test.ts +6 -1
  319. package/src/shared/components/Button.tsx +16 -2
  320. package/src/shared/components/Dialog.tsx +27 -11
  321. package/src/shared/components/Menu.tsx +13 -1
  322. package/src/shared/components/PageShell.tsx +13 -8
  323. package/src/shared/components/__tests__/primitives.test.tsx +116 -2
  324. package/src/shared/components/__tests__/useFocusHandoff.test.tsx +192 -0
  325. package/src/shared/components/index.ts +2 -0
  326. package/src/shared/components/useDismissableMenu.ts +32 -10
  327. package/src/shared/components/useFocusHandoff.ts +51 -0
  328. package/src/shared/components/useLatestRef.ts +28 -0
  329. package/src/shared/markdown/Markdown.tsx +12 -3
  330. package/src/shared/markdown/__tests__/escapeSpacesInLinkDestinations.test.ts +39 -0
  331. package/src/shared/markdown/hrefs.ts +50 -0
  332. package/src/shared/marketplace-url.ts +33 -5
  333. package/src/shared/mcp/ChatGptInstallLink.tsx +3 -3
  334. package/src/shared/mcp/ConnectionInstructions.tsx +38 -27
  335. package/src/shared/mcp/__tests__/connect-snippets.test.ts +3 -3
  336. package/src/shared/mcp/connect-snippets.ts +14 -9
  337. package/src/shared/mcp/index.ts +1 -1
  338. package/src/shared/theme/__tests__/header-band.test.ts +197 -0
  339. package/src/shared/theme/header.ts +75 -0
  340. package/src/shared/theme/measure.ts +7 -4
  341. package/src/shared/theme/tokens.css +25 -0
  342. package/src/modules/library/__tests__/PluginsIndexPage.test.tsx +0 -363
  343. package/src/modules/library/__tests__/PluginsSidebar.locked.test.tsx +0 -97
  344. package/src/modules/library/components/PluginsIndexPage.tsx +0 -270
  345. package/src/modules/update-check/__tests__/UpdateBanner.test.tsx +0 -126
  346. package/src/modules/update-check/components/UpdateBanner.tsx +0 -92
  347. package/src/modules/update-check/services/update-check.api.ts +0 -24
@@ -1,9 +1,10 @@
1
- import { useCallback, useRef, useState } from 'react';
1
+ import { useCallback, useRef, useState, type Ref } from 'react';
2
2
  import {
3
3
  Check,
4
4
  ChevronDown,
5
5
  Clock4,
6
6
  Copy,
7
+ FileText,
7
8
  History,
8
9
  Link2,
9
10
  Pencil,
@@ -13,6 +14,8 @@ import {
13
14
  import { cn } from '../../../lib/utils';
14
15
  import { Badge, Button, IconButton, MenuItem, MenuPanel } from '../../../shared/components';
15
16
  import { useDismissableMenu } from '../../../shared/components';
17
+ import { HEADER_BAND, PAGE_HEADER_TESTID } from '../../../shared/theme/header';
18
+ import { rootAnchoredPath } from '../utils/pasteLink';
16
19
 
17
20
  /**
18
21
  * The document's title, and the page's actions beside it.
@@ -24,7 +27,9 @@ import { useDismissableMenu } from '../../../shared/components';
24
27
  * Weight follows stakes, not frequency (proto:3781-3783). Share is the ONE
25
28
  * bounded button because it is the one action here with a consequence for
26
29
  * other people. Copy and Edit are icons — frequent, private, instantly
27
- * reversible. Everything monthly is behind `⋯`.
30
+ * reversible. Version history is the clock-arrow beside Edit, the placement
31
+ * Google Docs taught everyone; a ⋯ holding one item was a hiding place, not
32
+ * an overflow.
28
33
  */
29
34
 
30
35
  /** Extensions we strip from the `<h1>`. Anything else stays verbatim. */
@@ -68,6 +73,28 @@ export interface KbPageHeaderProps {
68
73
  * they have no bar to carry them.
69
74
  */
70
75
  writeActionInPane?: boolean;
76
+ /**
77
+ * The pane bar carries Version history beside its Edit, so the header
78
+ * renders none. True for prose documents — the ones that get a pane card.
79
+ * Separate from `writeActionInPane`, which `viewOnly` also raises: a
80
+ * view-only full-bleed file has no bar to carry the button, and its log is
81
+ * still worth reading.
82
+ */
83
+ historyInPane?: boolean;
84
+ /**
85
+ * The header's Version history clock, for the viewer to focus after a
86
+ * swap unmounts the control that was activated (see `FileViewer`).
87
+ */
88
+ historyButtonRef?: Ref<HTMLButtonElement>;
89
+ /**
90
+ * The document's own title, as the LAST place focus can land when a swap
91
+ * unmounts the control that was activated and both clocks are withdrawn
92
+ * (git not answering, or a draft open — see `FileViewer.backToDocument`).
93
+ * The heading is on screen in every one of those states and it names the
94
+ * thing the user just came back to, so a screen reader announces the
95
+ * document rather than nothing at all.
96
+ */
97
+ titleRef?: Ref<HTMLHeadingElement>;
71
98
  /** Disables Edit and explains why via `title`. */
72
99
  lockedBy: string | null;
73
100
  historyAvailable: boolean;
@@ -93,8 +120,8 @@ export interface KbPageHeaderProps {
93
120
  onShare(): void;
94
121
  /** The page as Markdown. Absent for a file that has no markdown to copy. */
95
122
  onCopyPage?: () => Promise<boolean>;
96
- /** The canonical URL, via `useCanonicalFileUrl`. The only copy-a-reference
97
- * action on this page — see the note where the `⋯` menu is built. */
123
+ /** The canonical URL, via `useCanonicalFileUrl`. Its sibling, Copy path,
124
+ * needs nothing from the caller: it is `path`, root-anchored. */
98
125
  onCopyLink(): Promise<boolean>;
99
126
  }
100
127
 
@@ -127,6 +154,9 @@ export function KbPageHeader({
127
154
  onSendProposal,
128
155
  onDiscardProposal,
129
156
  writeActionInPane = false,
157
+ historyInPane = false,
158
+ historyButtonRef,
159
+ titleRef,
130
160
  lockedBy,
131
161
  historyAvailable,
132
162
  isDirty,
@@ -141,23 +171,15 @@ export function KbPageHeader({
141
171
  onCopyLink,
142
172
  }: KbPageHeaderProps) {
143
173
  const [shareOpen, setShareOpen] = useState(false);
144
- const [dotsOpen, setDotsOpen] = useState(false);
145
174
  const [copied, setCopied] = useState<Record<string, CopyState>>({});
146
175
  const shareTriggerRef = useRef<HTMLButtonElement>(null);
147
- const dotsTriggerRef = useRef<HTMLButtonElement>(null);
148
176
 
149
177
  const closeShare = useCallback(() => setShareOpen(false), []);
150
- const closeDots = useCallback(() => setDotsOpen(false), []);
151
178
  const shareRef = useDismissableMenu<HTMLDivElement>({
152
179
  open: shareOpen,
153
180
  onClose: closeShare,
154
181
  returnFocusTo: shareTriggerRef,
155
182
  });
156
- const dotsRef = useDismissableMenu<HTMLDivElement>({
157
- open: dotsOpen,
158
- onClose: closeDots,
159
- returnFocusTo: dotsTriggerRef,
160
- });
161
183
 
162
184
  const report = useCallback(async (key: string, run: () => Promise<boolean>) => {
163
185
  const ok = await run();
@@ -165,6 +187,18 @@ export function KbPageHeader({
165
187
  window.setTimeout(() => setCopied((prev) => ({ ...prev, [key]: null })), COPY_FEEDBACK_MS);
166
188
  }, []);
167
189
 
190
+ // The root-anchored `/<kbDirName>/…` form, the same text the tree row's
191
+ // Copy path gives: pasted into a Markdown link it works from any folder.
192
+ const copyPath = useCallback(async () => {
193
+ try {
194
+ await navigator.clipboard.writeText(rootAnchoredPath(path));
195
+ return true;
196
+ } catch (err) {
197
+ console.error('Failed to copy path:', err);
198
+ return false;
199
+ }
200
+ }, [path]);
201
+
168
202
  const copyLabel = (key: string, idle: string) =>
169
203
  copied[key] === 'ok' ? 'Copied' : copied[key] === 'fail' ? "Couldn't copy" : idle;
170
204
 
@@ -182,20 +216,52 @@ export function KbPageHeader({
182
216
  !writeActionInPane && canWrite === false && !isReviewingPending && activeTab === 'content';
183
217
 
184
218
  return (
185
- <div className="mb-2 flex flex-wrap items-center gap-3">
186
- <h1 className="min-w-0 text-display font-semibold text-ink">{titleOf(path)}</h1>
219
+ // The shared header band: the same height as the sidebar's header row,
220
+ // from the same token, so the two rows under the toolbar read as one
221
+ // line. It used to be `flex-wrap` with no height at all — the row was as
222
+ // tall as whatever landed in it, which is why it could never agree with
223
+ // the sidebar. Wrapping is gone with the height: the title truncates
224
+ // instead (below), because a title bar that becomes two rows has already
225
+ // broken the seam this band exists to hold.
226
+ <div
227
+ data-testid={PAGE_HEADER_TESTID}
228
+ className={cn(HEADER_BAND, 'mb-2 w-full gap-3')}
229
+ >
230
+ {/* The title and its chips are the one part of this row allowed to run
231
+ out of space. They share a `min-w-0` group so that the row's
232
+ leftover width is taken from THEM and never from the actions: a
233
+ band cannot wrap, so something has to give first, and a file name
234
+ the reader can still hover for (`title`, below) is a far cheaper
235
+ loss than a Share button pushed off the side of the page. The
236
+ chips clip from the right in the order they are least urgent. */}
237
+ <div className="flex min-w-0 flex-1 items-center gap-3 overflow-hidden">
238
+ {/* `tabIndex={-1}` keeps the heading out of the tab order while letting
239
+ `.focus()` land on it — the standard way to hand focus to a region
240
+ after a view swap. No focus ring: this is a programmatic landing
241
+ after the user's own click, not a control they are about to use. */}
242
+ <h1
243
+ ref={titleRef}
244
+ tabIndex={-1}
245
+ // `title` because `truncate` hides the rest of a long file name, and
246
+ // a heading you cannot finish reading needs somewhere to say it.
247
+ title={titleOf(path)}
248
+ className="min-w-0 truncate text-display font-semibold text-ink focus:outline-none"
249
+ >
250
+ {titleOf(path)}
251
+ </h1>
187
252
 
188
- {/* The three chips the deleted strip used to carry. */}
189
- {isDirty && <Badge tone="wait">Unsaved</Badge>}
190
- {waitingOnAgentUpdate && (
191
- <Badge tone="wait">
192
- <Clock4 size={12} />
193
- Agent update waiting
194
- </Badge>
195
- )}
196
- {isReviewingPending && <Badge tone="ok">Reviewing agent update</Badge>}
253
+ {/* The three chips the deleted strip used to carry. */}
254
+ {isDirty && <Badge tone="wait">Unsaved</Badge>}
255
+ {waitingOnAgentUpdate && (
256
+ <Badge tone="wait">
257
+ <Clock4 size={12} />
258
+ Agent update waiting
259
+ </Badge>
260
+ )}
261
+ {isReviewingPending && <Badge tone="ok">Reviewing agent update</Badge>}
262
+ </div>
197
263
 
198
- <div className="ml-auto flex flex-none items-center gap-1.5">
264
+ <div className="flex flex-none items-center gap-1.5">
199
265
  {/* Share: bounded, and split. Bounded because it is the one action on
200
266
  this page with a consequence for other people. The chevron carries
201
267
  the quieter sibling errand — copying a link to the page — so that
@@ -248,6 +314,19 @@ export function KbPageHeader({
248
314
  {copyLabel('link', 'Copy link to this page')}
249
315
  </span>
250
316
  </MenuItem>
317
+ {/* For linking this page from another one. */}
318
+ <MenuItem
319
+ role="menuitem"
320
+ onClick={async () => {
321
+ await report('path', copyPath);
322
+ window.setTimeout(closeShare, COPY_FEEDBACK_MS);
323
+ }}
324
+ >
325
+ <span className="flex items-center gap-2.5">
326
+ <FileText size={14} />
327
+ {copyLabel('path', 'Copy path')}
328
+ </span>
329
+ </MenuItem>
251
330
  {/* "Share the whole folder" lived here and was cut. Sharing a
252
331
  folder from a file's page is a much bigger act than the row
253
332
  it sat in suggested — one click, and everything inside the
@@ -352,37 +431,23 @@ export function KbPageHeader({
352
431
  </IconButton>
353
432
  ))}
354
433
 
355
- {/* Version history is the whole menu now, so the trigger goes where it
356
- goes: git not ready means there is nothing behind ⋯, and an overflow
357
- that opens onto an empty panel is worse than no overflow at all. */}
358
- {historyAvailable && (
359
- <div className="relative">
360
- <IconButton
361
- ref={dotsTriggerRef}
362
- aria-label="More actions"
363
- aria-haspopup="menu"
364
- aria-expanded={dotsOpen}
365
- active={dotsOpen}
366
- onClick={() => setDotsOpen((v) => !v)}
367
- >
368
- <span aria-hidden className="text-strong leading-none">⋯</span>
369
- </IconButton>
370
- {dotsOpen && (
371
- <div ref={dotsRef} className="absolute right-0 top-[calc(100%+5px)] z-40">
372
- <MenuPanel role="menu" aria-label="More actions" className="min-w-[212px]">
373
- <MenuItem role="menuitem" onClick={() => { closeDots(); onOpenHistory(); }}>
374
- <span className="flex items-center gap-2.5"><History size={14} />Version history</span>
375
- </MenuItem>
376
- {/* "Copy path" is NOT here. Copying a reference to this page is
377
- one errand, and Share already owns it ("Copy link to this
378
- page"); two menus offering near-identical copies is how a
379
- user ends up pasting the wrong one. The tree's right-click
380
- menu keeps its own Copy path, because there it reaches rows
381
- that are not open — a different job. */}
382
- </MenuPanel>
383
- </div>
384
- )}
385
- </div>
434
+ {/* Version history, as the clock-arrow beside Edit. It was the lone
435
+ item behind a ⋯ here, and a menu with one entry is a hiding place,
436
+ not an overflow. Prose documents put Edit in the pane bar and carry
437
+ this beside it (`historyInPane`); full-bleed renderers have no bar,
438
+ so the header keeps both. Git not ready means there is no log to
439
+ show, and the button goes with it. */}
440
+ {historyAvailable && !historyInPane && (
441
+ <IconButton
442
+ ref={historyButtonRef}
443
+ aria-label="Version history"
444
+ title="Version history"
445
+ active={activeTab === 'history'}
446
+ aria-pressed={activeTab === 'history'}
447
+ onClick={onOpenHistory}
448
+ >
449
+ <History size={14} />
450
+ </IconButton>
386
451
  )}
387
452
  </div>
388
453
  </div>
@@ -0,0 +1,350 @@
1
+ import { useEffect, useRef } from 'react';
2
+ import type { FileTreeEntry, FolderChangeRequest } from '@bevel-software/platform-shared';
3
+ import { Button, Dialog, useLatestRef } from '../../../shared/components';
4
+ import {
5
+ ACCESS_CHANGE_UNKNOWN,
6
+ NO_ACCESS_CHANGE,
7
+ deleteSentence,
8
+ folderRequestLine,
9
+ moveQuestion,
10
+ moveSentence,
11
+ withdrawSentence,
12
+ type AccessChange,
13
+ } from '../utils/treeConfirm';
14
+
15
+ /**
16
+ * What the tree asks before it deletes or moves. Both verbs used to act on
17
+ * the click: Delete removed a file (or a whole folder) with no second chance,
18
+ * and a drop moved a file into another folder without a word about what that
19
+ * means — access is attached to folders, so every cross-folder move is an
20
+ * access change.
21
+ *
22
+ * A third verb joined them: Withdraw, on a proposed row, which cancels the
23
+ * change request the row stands for — destructive in the same way, and asked
24
+ * in the same place rather than in a confirm() the tree has nowhere else.
25
+ *
26
+ * One request is open at a time, held by `TreeChrome`; the rows only describe
27
+ * what they are about to do and hand over the operation to run on Confirm.
28
+ */
29
+ export type TreeConfirmRequest =
30
+ | {
31
+ kind: 'delete';
32
+ entry: FileTreeEntry;
33
+ /**
34
+ * Today's delete, unchanged: this branch's copy of the entry. For a
35
+ * folder with proposed files it is "Delete current content only" — what
36
+ * the branch holds goes, and the change requests proposing files into
37
+ * the folder stay open. (Not "delete folder only": the folder is what
38
+ * the proposals still fill, so it does not leave the tree.)
39
+ */
40
+ run(): void | Promise<void>;
41
+ /**
42
+ * "Delete folder and its proposed changes": the delete above, then every
43
+ * open change request proposing files under the folder loses them.
44
+ * Offered only for a folder that has proposed files.
45
+ */
46
+ runWithProposals?(): void | Promise<void>;
47
+ /** Rows that are only proposed — not on this branch, so not counted. */
48
+ isProposed?(path: string): boolean;
49
+ /**
50
+ * The listing this entry came from had entries withheld by the caller's
51
+ * read rules: the delete takes files the count cannot see, and the
52
+ * sentence says so rather than naming a number that is too small.
53
+ */
54
+ partial?: boolean;
55
+ /** The row to hand focus back to once the dialog is cancelled. */
56
+ returnFocusTo(): HTMLElement | null;
57
+ /**
58
+ * Where focus goes once the operation runs instead: the entry's own row
59
+ * is about to leave the tree, and focus would fall to the page with it.
60
+ */
61
+ focusAfterRun(): HTMLElement | null;
62
+ }
63
+ | {
64
+ kind: 'move';
65
+ /** Workspace-relative path of the entry being moved. */
66
+ sourcePath: string;
67
+ /**
68
+ * Is the thing being dragged a folder? A folder's access is its own
69
+ * `access.md` plus every file under it — a different question from one
70
+ * file's, and not one this dialog answers, so it asks nothing and says
71
+ * only what it has always said.
72
+ */
73
+ sourceIsDirectory: boolean;
74
+ /** Workspace-relative folder it lands in; `''` is the workspace root. */
75
+ targetDir: string;
76
+ /** How the destination reads in the sentence — the drop target's row name. */
77
+ destinationLabel: string;
78
+ /** Today's move, unchanged. */
79
+ run(): void | Promise<void>;
80
+ returnFocusTo(): HTMLElement | null;
81
+ focusAfterRun(): HTMLElement | null;
82
+ }
83
+ | {
84
+ /**
85
+ * The author takes their own suggestion back — the same cancel the file
86
+ * page's change box calls its Withdraw, reached from the proposed row
87
+ * in the sidebar instead. Only ever asked for a request the caller
88
+ * authored; an owner's "no" on someone else's is Decline, in the dialog.
89
+ */
90
+ kind: 'withdraw';
91
+ /** The request being cancelled — withdrawal is per request, not per file. */
92
+ crNumber: number;
93
+ /**
94
+ * Every file the request carries. One row was right-clicked, but the
95
+ * whole request goes, so the sentence counts them.
96
+ */
97
+ files: string[];
98
+ run(): void | Promise<void>;
99
+ returnFocusTo(): HTMLElement | null;
100
+ focusAfterRun(): HTMLElement | null;
101
+ };
102
+
103
+ /**
104
+ * What a folder delete knows about the change requests proposing files in the
105
+ * folder: nothing to ask (`none`), still asking, the answer, or no answer —
106
+ * in which case the delete is offered as it always was, with a note.
107
+ */
108
+ export type FolderProposals =
109
+ | { status: 'none' }
110
+ | { status: 'loading' }
111
+ | { status: 'ready'; requests: FolderChangeRequest[] }
112
+ | { status: 'failed' };
113
+
114
+ /**
115
+ * What a move knows about the access it is about to change.
116
+ *
117
+ * The lookup decorates the confirmation; it never gates it. `loading` and
118
+ * `failed` both leave Move enabled — a dialog that waited on an access
119
+ * resolution would be a dialog a slow resolver could hang.
120
+ *
121
+ * - `unavailable`: nothing to resolve. The move is not governed by the KB
122
+ * access tree (one end sits outside the KB clone), so the dialog claims
123
+ * nothing about access beyond the sentence it always said.
124
+ * - `loading`: asked, still waiting — up to two seconds, then `failed`.
125
+ * - `ready`: answered. Empty on both sides means nobody's access changes.
126
+ * - `failed`: refused, errored, or out of time.
127
+ */
128
+ export type MoveAccessChange =
129
+ | { status: 'unavailable' }
130
+ | { status: 'loading' }
131
+ | ({ status: 'ready' } & AccessChange)
132
+ | { status: 'failed' };
133
+
134
+ /** Which delete a Confirm runs. */
135
+ export type DeleteMode = 'folder-only' | 'with-proposals';
136
+
137
+ /**
138
+ * The dialog for one request. Escape and the scrim cancel (the shared
139
+ * `Dialog`); Enter confirms — unless focus sits on Cancel or Close, where
140
+ * Enter presses the focused button like anywhere else. Focus starts on the
141
+ * confirm button so Enter-to-confirm is also what a screen reader announces.
142
+ */
143
+ export function TreeActionConfirmDialog({
144
+ request,
145
+ warnings,
146
+ accessChange = { status: 'unavailable' },
147
+ proposals = { status: 'none' },
148
+ onCancel,
149
+ onConfirm,
150
+ }: {
151
+ request: TreeConfirmRequest;
152
+ /** Move warnings, derived by the caller (the writable one arrives late). */
153
+ warnings: string[];
154
+ /** Who a move costs and gains access, looked up by the caller. */
155
+ accessChange?: MoveAccessChange;
156
+ /** A folder delete's open change requests, looked up by the caller. */
157
+ proposals?: FolderProposals;
158
+ onCancel(): void;
159
+ onConfirm(mode: DeleteMode): void;
160
+ }) {
161
+ const confirmRef = useRef<HTMLButtonElement>(null);
162
+ const onConfirmRef = useLatestRef(onConfirm);
163
+
164
+ // Runs after the Dialog's own open effect (child effects first), so this
165
+ // focus wins over the Dialog's first-focusable default: the header's Close.
166
+ useEffect(() => {
167
+ confirmRef.current?.focus();
168
+ function onKeyDown(e: KeyboardEvent) {
169
+ if (e.key !== 'Enter') return;
170
+ const active = document.activeElement;
171
+ if (active instanceof HTMLButtonElement && active !== confirmRef.current) return;
172
+ if (confirmRef.current?.disabled) return;
173
+ e.preventDefault();
174
+ onConfirmRef.current('folder-only');
175
+ }
176
+ document.addEventListener('keydown', onKeyDown);
177
+ return () => document.removeEventListener('keydown', onKeyDown);
178
+ }, [onConfirmRef]);
179
+
180
+ const isDelete = request.kind === 'delete';
181
+ const isWithdraw = request.kind === 'withdraw';
182
+ const isMove = request.kind === 'move';
183
+ const name = isMove ? (request.sourcePath.split('/').pop() ?? '') : '';
184
+ const requests = isDelete && proposals.status === 'ready' ? proposals.requests : [];
185
+ if (isDelete && requests.length > 0) {
186
+ // The three-way question: this branch only, or its proposals too. The
187
+ // second verb needs the caller to be allowed on EVERY listed request.
188
+ const refused = requests.flatMap((r) => (r.mayRemove ? [] : [r]));
189
+ return (
190
+ <Dialog
191
+ open
192
+ // Three actions: at `md` the footer ran wider than the dialog and
193
+ // pushed Cancel past its left edge. They also wrap, so a narrow
194
+ // viewport stacks them instead of cutting one off.
195
+ size="lg"
196
+ onClose={onCancel}
197
+ title="Delete folder"
198
+ footer={
199
+ <div className="flex flex-wrap justify-end gap-2">
200
+ <Button size="sm" onClick={onCancel}>
201
+ Cancel
202
+ </Button>
203
+ <Button ref={confirmRef} size="sm" onClick={() => onConfirm('folder-only')}>
204
+ Delete current content only
205
+ </Button>
206
+ <Button
207
+ size="sm"
208
+ variant="danger"
209
+ disabled={refused.length > 0 || !request.runWithProposals}
210
+ aria-describedby={refused.length > 0 ? 'delete-proposals-refused' : undefined}
211
+ onClick={() => onConfirm('with-proposals')}
212
+ >
213
+ Delete folder and its proposed changes
214
+ </Button>
215
+ </div>
216
+ }
217
+ >
218
+ <p className="text-detail text-ink">{deleteSentence(request.entry, request.isProposed, request.partial)}</p>
219
+ <p className="mt-2 text-detail text-ink">
220
+ {requests.length === 1 ? 'An open change request proposes' : 'Open change requests propose'} files in it:
221
+ </p>
222
+ <ul className="mt-1 space-y-1">
223
+ {requests.map((r) => (
224
+ <li key={r.number} className="text-detail text-ink">
225
+ {folderRequestLine(r)}
226
+ </li>
227
+ ))}
228
+ </ul>
229
+ <p className="mt-2 text-detail text-ink-muted">
230
+ Deleting the current content only removes what is on this branch and keeps{' '}
231
+ {requests.length === 1 ? 'that request' : 'those requests'} open, so their proposed files
232
+ stay listed. Deleting the proposed changes too takes those files out of each request; a
233
+ request left with nothing in it is withdrawn.
234
+ </p>
235
+ {refused.length > 0 && (
236
+ <ul id="delete-proposals-refused" className="mt-2 space-y-1">
237
+ {refused.map((r) => (
238
+ <li key={r.number} role="note" className="text-detail text-danger">
239
+ {r.reason}
240
+ </li>
241
+ ))}
242
+ </ul>
243
+ )}
244
+ </Dialog>
245
+ );
246
+ }
247
+ const checking = isDelete && proposals.status === 'loading';
248
+ return (
249
+ <Dialog
250
+ open
251
+ size="sm"
252
+ onClose={onCancel}
253
+ title={isDelete ? 'Delete' : isWithdraw ? 'Withdraw suggestion' : 'Move'}
254
+ footer={
255
+ <>
256
+ <Button size="sm" onClick={onCancel}>
257
+ Cancel
258
+ </Button>
259
+ <Button
260
+ ref={confirmRef}
261
+ size="sm"
262
+ // A withdraw takes the request away from the owners reviewing it:
263
+ // the same danger tone a delete gets, for the same reason.
264
+ variant={isDelete || isWithdraw ? 'danger' : 'primary'}
265
+ disabled={checking}
266
+ onClick={() => onConfirm('folder-only')}
267
+ >
268
+ {isDelete ? 'Delete' : isWithdraw ? 'Withdraw' : 'Move'}
269
+ </Button>
270
+ </>
271
+ }
272
+ >
273
+ <p className="text-detail text-ink">
274
+ {request.kind === 'delete'
275
+ ? deleteSentence(request.entry, request.isProposed, request.partial)
276
+ : request.kind === 'withdraw'
277
+ ? withdrawSentence(request.files)
278
+ : moveHeadline(name, request.destinationLabel, accessChange)}
279
+ </p>
280
+ {isMove && accessChange.status === 'loading' && (
281
+ <p className="mt-2 text-detail text-ink-muted">Working out who this changes access for…</p>
282
+ )}
283
+ {isMove && accessChange.status === 'ready' && (
284
+ <>
285
+ <AccessBlock title="Will lose access:" lines={accessChange.lose} />
286
+ <AccessBlock title="Will gain access:" lines={accessChange.gain} />
287
+ </>
288
+ )}
289
+ {isMove && accessChange.status === 'failed' && (
290
+ <p role="note" className="mt-2 text-detail text-ink-muted">
291
+ {ACCESS_CHANGE_UNKNOWN}
292
+ </p>
293
+ )}
294
+ {checking && <p className="mt-2 text-detail text-ink-muted">Checking open change requests…</p>}
295
+ {isDelete && proposals.status === 'failed' && (
296
+ <p role="note" className="mt-2 text-detail text-ink-muted">
297
+ Couldn't check which change requests propose files here. Delete removes only this branch's
298
+ files; any proposals stay open.
299
+ </p>
300
+ )}
301
+ {warnings.length > 0 && (
302
+ <ul className="mt-2 space-y-1">
303
+ {warnings.map((w) => (
304
+ <li key={w} role="note" className="text-detail text-danger">
305
+ {w}
306
+ </li>
307
+ ))}
308
+ </ul>
309
+ )}
310
+ </Dialog>
311
+ );
312
+ }
313
+
314
+ /**
315
+ * The move's first line. A resolved lookup that found nothing says so outright;
316
+ * one that found something leaves the blocks below to say it. An unanswered
317
+ * lookup falls back to the sentence the dialog said before it existed, rather
318
+ * than a bare question with nothing under it.
319
+ */
320
+ function moveHeadline(name: string, destination: string, access: MoveAccessChange): string {
321
+ if (access.status === 'ready') {
322
+ const question = moveQuestion(name, destination);
323
+ return access.lose.length === 0 && access.gain.length === 0
324
+ ? `${question} ${NO_ACCESS_CHANGE}`
325
+ : question;
326
+ }
327
+ if (access.status === 'loading') return moveQuestion(name, destination);
328
+ return moveSentence(name, destination);
329
+ }
330
+
331
+ /** One "Will lose access:" / "Will gain access:" block, or nothing when empty. */
332
+ function AccessBlock({ title, lines }: { title: string; lines: string[] }) {
333
+ if (lines.length === 0) return null;
334
+ return (
335
+ <>
336
+ <p className="mt-2 text-detail text-ink">{title}</p>
337
+ <ul className="mt-1 space-y-1">
338
+ {/* Two principals can read the same — a group and a role sharing a
339
+ name spell one line identically — so position, not text, is what
340
+ tells the rows apart. The list is re-derived from the answer on
341
+ every render and holds no state of its own. */}
342
+ {lines.map((line, i) => (
343
+ <li key={`${i}:${line}`} className="text-detail text-ink">
344
+ {line}
345
+ </li>
346
+ ))}
347
+ </ul>
348
+ </>
349
+ );
350
+ }