@bevel-software/platform-core-frontend 0.15.1 → 0.19.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 (346) hide show
  1. package/THIRD-PARTY-NOTICES.md +2 -2
  2. package/package.json +3 -3
  3. package/src/core/CoreAppShell.tsx +16 -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__/ConnectionKeysPage.test.tsx +266 -0
  32. package/src/modules/admin/__tests__/DirectoryGroupsPage.suggest.test.tsx +182 -0
  33. package/src/modules/admin/__tests__/DirectoryGroupsPage.test.tsx +165 -14
  34. package/src/modules/admin/__tests__/UserAccountsPage.test.tsx +401 -4
  35. package/src/modules/admin/__tests__/group-members-path.test.ts +27 -0
  36. package/src/modules/admin/components/AddMemberInput.tsx +268 -0
  37. package/src/modules/admin/components/AdminRolesPage.tsx +97 -132
  38. package/src/modules/admin/components/ConnectionKeysPage.tsx +269 -0
  39. package/src/modules/admin/components/DirectoryGroupsPage.tsx +91 -39
  40. package/src/modules/admin/components/UserAccountsPage.tsx +271 -37
  41. package/src/modules/admin/components/connection-keys-grouping.ts +43 -0
  42. package/src/modules/admin/components/group-members-path.ts +32 -0
  43. package/src/modules/admin/services/connection-keys.api.ts +47 -0
  44. package/src/modules/admin/services/roles.api.ts +12 -1
  45. package/src/modules/auth/__tests__/AccountPage.test.tsx +50 -2
  46. package/src/modules/auth/components/AccountPage.tsx +73 -54
  47. package/src/modules/auth/components/LoginScreen.tsx +1 -0
  48. package/src/modules/auth/services/account.api.ts +78 -4
  49. package/src/modules/change-requests/__tests__/ChangeRequestDialog.access-rules.test.tsx +144 -0
  50. package/src/modules/change-requests/__tests__/ChangeRequestDialog.binary.test.tsx +422 -0
  51. package/src/modules/change-requests/__tests__/ChangeRequestDialog.brings-itself-up-to-date.test.tsx +431 -0
  52. package/src/modules/change-requests/__tests__/ChangeRequestDialog.fork-point.test.tsx +193 -0
  53. package/src/modules/change-requests/__tests__/ChangeRequestDialog.initial-file.test.tsx +142 -0
  54. package/src/modules/change-requests/__tests__/ChangeRequestDialog.moved.test.tsx +202 -0
  55. package/src/modules/change-requests/__tests__/ChangeRequestDialog.test.tsx +205 -13
  56. package/src/modules/change-requests/__tests__/ChangeRequestDialog.unreadable.test.tsx +271 -0
  57. package/src/modules/change-requests/__tests__/FileChangeBoxes.test.tsx +208 -0
  58. package/src/modules/change-requests/__tests__/apply-outcome-for-every-viewer.test.tsx +286 -0
  59. package/src/modules/change-requests/__tests__/propose.concurrent.test.ts +273 -0
  60. package/src/modules/change-requests/__tests__/readFailure.test.ts +122 -0
  61. package/src/modules/change-requests/__tests__/useCrFileDiffs.test.tsx +238 -0
  62. package/src/modules/change-requests/__tests__/useFileOnBranch.test.tsx +56 -1
  63. package/src/modules/change-requests/__tests__/useForkPointFile.test.tsx +79 -0
  64. package/src/modules/change-requests/components/BranchFilePreview.tsx +357 -0
  65. package/src/modules/change-requests/components/ChangeBox.tsx +31 -2
  66. package/src/modules/change-requests/components/ChangeRequestDialog.tsx +862 -72
  67. package/src/modules/change-requests/components/CrFileTree.tsx +74 -58
  68. package/src/modules/change-requests/components/FileChangeBoxes.tsx +19 -15
  69. package/src/modules/change-requests/hooks/useApplyChangeRequest.ts +41 -7
  70. package/src/modules/change-requests/hooks/useCrFileDiffs.ts +181 -23
  71. package/src/modules/change-requests/hooks/useFileOnBranch.ts +70 -7
  72. package/src/modules/change-requests/hooks/useForkPointFile.ts +77 -0
  73. package/src/modules/change-requests/services/change-requests.api.ts +57 -1
  74. package/src/modules/change-requests/services/denied-file.api.ts +53 -0
  75. package/src/modules/change-requests/services/propose.api.ts +97 -8
  76. package/src/modules/change-requests/utils/approval.ts +15 -0
  77. package/src/modules/change-requests/utils/author.ts +32 -0
  78. package/src/modules/change-requests/utils/readFailure.ts +110 -0
  79. package/src/modules/git/__tests__/FileHistoryPanel.test.tsx +20 -0
  80. package/src/modules/git/components/FileHistoryPanel.tsx +5 -0
  81. package/src/modules/git/components/PullRequestsForMe.tsx +51 -24
  82. package/src/modules/git/services/__tests__/error-messages.test.ts +29 -0
  83. package/src/modules/git/services/error-messages.ts +12 -0
  84. package/src/modules/git/services/pr-prompts.ts +5 -5
  85. package/src/modules/layout/__tests__/HeaderAlignment.test.tsx +401 -0
  86. package/src/modules/layout/__tests__/SidebarFooterGrid.test.tsx +286 -0
  87. package/src/modules/layout/__tests__/SidebarFrameResponsive.test.tsx +61 -0
  88. package/src/modules/layout/components/AppLayout.tsx +2 -0
  89. package/src/modules/layout/components/MobileChatLayout.tsx +4 -1
  90. package/src/modules/layout/components/ResizableThreePaneLayout.tsx +4 -1
  91. package/src/modules/layout/components/SidebarFrame.tsx +108 -3
  92. package/src/modules/library/__tests__/AddToPluginDialog.test.tsx +171 -5
  93. package/src/modules/library/__tests__/DeleteToolDialog.test.tsx +356 -0
  94. package/src/modules/library/__tests__/IntegrationsSetupReminder.test.tsx +60 -0
  95. package/src/modules/library/__tests__/LibraryCard.test.tsx +91 -10
  96. package/src/modules/library/__tests__/LibraryRoutes.test.tsx +242 -107
  97. package/src/modules/library/__tests__/LibrarySidebarMenu.test.tsx +103 -98
  98. package/src/modules/library/__tests__/LinkSkillPanel.test.tsx +20 -5
  99. package/src/modules/library/__tests__/LockedPluginView.test.tsx +97 -7
  100. package/src/modules/library/__tests__/NewPluginDialog.test.tsx +13 -4
  101. package/src/modules/library/__tests__/PersonalAddDialog.test.tsx +79 -3
  102. package/src/modules/library/__tests__/PersonalPluginPage.test.tsx +201 -0
  103. package/src/modules/library/__tests__/PluginExtras.test.tsx +100 -9
  104. package/src/modules/library/__tests__/PluginJoinRequests.test.tsx +60 -1
  105. package/src/modules/library/__tests__/PluginPage.test.tsx +258 -6
  106. package/src/modules/library/__tests__/PluginsSidebar.contextmenu.test.tsx +16 -56
  107. package/src/modules/library/__tests__/PluginsSidebar.test.tsx +155 -152
  108. package/src/modules/library/__tests__/PluginsSidebarMenu.test.tsx +16 -0
  109. package/src/modules/library/__tests__/SharedViaPlugins.test.tsx +106 -0
  110. package/src/modules/library/__tests__/SkillPage.test.tsx +386 -80
  111. package/src/modules/library/__tests__/SkillsTree.test.tsx +293 -4
  112. package/src/modules/library/__tests__/ToolConnectionSection.test.tsx +582 -71
  113. package/src/modules/library/__tests__/ToolPage.test.tsx +87 -4
  114. package/src/modules/library/__tests__/WorkspaceItemRoute.test.tsx +173 -26
  115. package/src/modules/library/__tests__/auth-harness.tsx +9 -9
  116. package/src/modules/library/__tests__/card-row-menu.test.tsx +320 -0
  117. package/src/modules/library/__tests__/library-data.mapping.test.tsx +98 -0
  118. package/src/modules/library/__tests__/library-data.stale.test.tsx +121 -28
  119. package/src/modules/library/__tests__/library-data.test.ts +7 -0
  120. package/src/modules/library/__tests__/library-paths.test.ts +47 -4
  121. package/src/modules/library/__tests__/link-membership.test.ts +13 -4
  122. package/src/modules/library/__tests__/name-with-badges.test.tsx +273 -0
  123. package/src/modules/library/__tests__/newSkillMarkdown.test.ts +30 -0
  124. package/src/modules/library/__tests__/owner-pill.test.tsx +357 -0
  125. package/src/modules/library/__tests__/pending-tools.test.tsx +400 -0
  126. package/src/modules/library/__tests__/plugin-entries.test.ts +122 -0
  127. package/src/modules/library/__tests__/plugin-summary.test.ts +36 -1
  128. package/src/modules/library/__tests__/status.test.ts +82 -2
  129. package/src/modules/library/__tests__/tools.api.test.ts +44 -1
  130. package/src/modules/library/components/AccessRequestsBanner.tsx +85 -47
  131. package/src/modules/library/components/AddDialogTabs.tsx +103 -0
  132. package/src/modules/library/components/AddToPluginDialog.tsx +74 -18
  133. package/src/modules/library/components/IntegrationsSetupReminder.tsx +59 -0
  134. package/src/modules/library/components/ItemActionsMenu.tsx +288 -0
  135. package/src/modules/library/components/LibraryCard.tsx +146 -45
  136. package/src/modules/library/components/LibraryLayout.tsx +119 -256
  137. package/src/modules/library/components/LibraryPage.tsx +172 -39
  138. package/src/modules/library/components/LinkSkillPanel.tsx +1 -3
  139. package/src/modules/library/components/LockedPluginView.tsx +62 -34
  140. package/src/modules/library/components/NameWithBadges.tsx +164 -0
  141. package/src/modules/library/components/NewPluginDialog.tsx +16 -2
  142. package/src/modules/library/components/PageActions.tsx +11 -9
  143. package/src/modules/library/components/{PendingSkillReview.tsx → PendingItemReview.tsx} +14 -7
  144. package/src/modules/library/components/PersonalAddDialog.tsx +68 -18
  145. package/src/modules/library/components/PersonalPluginPage.tsx +121 -22
  146. package/src/modules/library/components/PluginExtras.tsx +140 -17
  147. package/src/modules/library/components/PluginIndexRow.tsx +47 -12
  148. package/src/modules/library/components/PluginPage.tsx +157 -41
  149. package/src/modules/library/components/PluginRows.tsx +286 -0
  150. package/src/modules/library/components/PluginsSidebar.tsx +239 -263
  151. package/src/modules/library/components/PluginsSidebarMenu.tsx +26 -1
  152. package/src/modules/library/components/ShareButton.tsx +17 -0
  153. package/src/modules/library/components/SkillsTree.tsx +141 -28
  154. package/src/modules/library/components/TeamRoute.tsx +15 -0
  155. package/src/modules/library/components/__tests__/upload-notices-once-per-page.test.tsx +144 -0
  156. package/src/modules/library/components/plugin-page-parts.tsx +103 -17
  157. package/src/modules/library/components/skill-page/SharedViaPlugins.tsx +6 -12
  158. package/src/modules/library/components/skill-page/SkillFilePane.tsx +5 -0
  159. package/src/modules/library/components/skill-page/SkillPage.tsx +274 -122
  160. package/src/modules/library/components/tool-page/DeleteToolDialog.tsx +218 -0
  161. package/src/modules/library/components/tool-page/ToolConnectionSection.tsx +79 -178
  162. package/src/modules/library/components/tool-page/ToolPage.tsx +106 -16
  163. package/src/modules/library/components/tool-page/ToolVarRow.tsx +42 -41
  164. package/src/modules/library/hooks/__tests__/useLibraryData.test.ts +98 -0
  165. package/src/modules/library/hooks/useLibraryData.ts +92 -19
  166. package/src/modules/library/routes/LibraryRoutes.tsx +14 -11
  167. package/src/modules/library/routes/WorkspaceItemRoute.tsx +77 -27
  168. package/src/modules/library/routes/library-paths.ts +26 -28
  169. package/src/modules/library/services/library.api.ts +38 -20
  170. package/src/modules/library/services/plugins.api.ts +69 -8
  171. package/src/modules/library/services/teams.api.ts +15 -0
  172. package/src/modules/library/services/tools.api.ts +78 -0
  173. package/src/modules/library/state/library-data.tsx +170 -32
  174. package/src/modules/library/utils/personal-plugin.ts +13 -15
  175. package/src/modules/library/utils/plugin-entries.ts +134 -0
  176. package/src/modules/library/utils/plugin-summary.ts +75 -9
  177. package/src/modules/library/utils/status.ts +135 -33
  178. package/src/modules/onboarding/__tests__/creator-welcome.test.tsx +8 -1
  179. package/src/modules/onboarding/__tests__/onboarding.test.tsx +853 -760
  180. package/src/modules/onboarding/agent-clients.ts +55 -23
  181. package/src/modules/onboarding/components/ConnectAgentPill.tsx +5 -1
  182. package/src/modules/onboarding/components/WelcomePage.tsx +98 -62
  183. package/src/modules/pr/services/pr-merge.api.ts +2 -1
  184. package/src/modules/review/components/MarkdownDiffViewer.tsx +53 -8
  185. package/src/modules/review/components/ReviewPanel.tsx +15 -17
  186. package/src/modules/review/components/__tests__/MarkdownDiffViewer.test.tsx +64 -0
  187. package/src/modules/review/components/__tests__/ReviewPanel.test.tsx +25 -1
  188. package/src/modules/secrets-vault/components/ConnectToolsPage.tsx +454 -117
  189. package/src/modules/secrets-vault/components/SecretsPage.tsx +48 -7
  190. package/src/modules/secrets-vault/components/ToolSecretsPanel.tsx +84 -5
  191. package/src/modules/secrets-vault/components/__tests__/ConnectToolsPage.test.tsx +425 -0
  192. package/src/modules/secrets-vault/components/__tests__/SecretsPage.test.tsx +417 -82
  193. package/src/modules/secrets-vault/components/__tests__/ToolSecretsPanel.test.tsx +105 -0
  194. package/src/modules/secrets-vault/components/__tests__/connect-lists-what-the-banner-counted.test.tsx +407 -0
  195. package/src/modules/secrets-vault/probe/SavedKeyProbeResult.tsx +98 -0
  196. package/src/modules/secrets-vault/probe/__tests__/probe-verdict.test.ts +160 -0
  197. package/src/modules/secrets-vault/probe/probe-verdict.ts +108 -0
  198. package/src/modules/secrets-vault/probe/useSavedKeyProbe.ts +228 -0
  199. package/src/modules/secrets-vault/services/connect.api.ts +36 -5
  200. package/src/modules/secrets-vault/utils/connect-status.ts +98 -0
  201. package/src/modules/settings/components/ClaudeConnectionCard.tsx +9 -24
  202. package/src/modules/settings/components/ClaudeConnectionFields.tsx +23 -0
  203. package/src/modules/settings/components/DeploymentPage.tsx +10 -30
  204. package/src/modules/settings/components/MarketplaceSection.tsx +152 -0
  205. package/src/modules/settings/components/__tests__/DeploymentPage.test.tsx +67 -4
  206. package/src/modules/settings/components/__tests__/MarketplaceSection.test.tsx +325 -0
  207. package/src/modules/settings/components/__tests__/SettingsLayout.test.tsx +5 -5
  208. package/src/modules/settings/services/github-facade.api.ts +23 -0
  209. package/src/modules/settings/settings-nav-items.tsx +10 -2
  210. package/src/modules/setup/__tests__/setup.oidc.test.tsx +172 -0
  211. package/src/modules/setup/__tests__/setup.probe-refusal.test.tsx +123 -0
  212. package/src/modules/setup/__tests__/setup.test.tsx +497 -4
  213. package/src/modules/setup/__tests__/useSetupStatus.test.tsx +130 -0
  214. package/src/modules/setup/components/SetupGate.tsx +16 -16
  215. package/src/modules/setup/components/SetupScreen.tsx +521 -43
  216. package/src/modules/setup/hooks/useSetupStatus.ts +93 -0
  217. package/src/modules/setup/services/setup.api.ts +140 -3
  218. package/src/modules/setup/utils/__tests__/root-folders.test.ts +72 -0
  219. package/src/modules/setup/utils/root-folders.ts +46 -0
  220. package/src/modules/toolbar/assets/claude-setup/01-add-manually.webp +0 -0
  221. package/src/modules/toolbar/assets/claude-setup/02-add-configuration.webp +0 -0
  222. package/src/modules/toolbar/assets/claude-setup/03-connect-account.webp +0 -0
  223. package/src/modules/toolbar/assets/claude-setup/04-pick-instance.webp +0 -0
  224. package/src/modules/toolbar/assets/claude-setup/05-plugins-add.webp +0 -0
  225. package/src/modules/toolbar/assets/claude-setup/06-add-marketplace.webp +0 -0
  226. package/src/modules/toolbar/assets/claude-setup/07-paste-url-sync.webp +0 -0
  227. package/src/modules/toolbar/assets/claude-setup/08-install-plugins.webp +0 -0
  228. package/src/modules/toolbar/assets/claude-setup/09-select-repository.webp +0 -0
  229. package/src/modules/toolbar/assets/claude-setup/10-connector-not-added.webp +0 -0
  230. package/src/modules/toolbar/assets/claude-setup/11-add-custom-connector.webp +0 -0
  231. package/src/modules/toolbar/assets/claude-setup/README.md +68 -0
  232. package/src/modules/toolbar/components/AgentInstructionsCard.tsx +296 -0
  233. package/src/modules/toolbar/components/ClaudeMarketplaceCarousel.tsx +107 -0
  234. package/src/modules/toolbar/components/ClaudeRegistrationSteps.tsx +127 -0
  235. package/src/modules/toolbar/components/CoworkSetupSteps.tsx +100 -0
  236. package/src/modules/toolbar/components/ExternalAgentAccessPage.tsx +177 -118
  237. package/src/modules/toolbar/components/ScreenshotStep.tsx +77 -0
  238. package/src/modules/toolbar/components/SetupCarousel.tsx +177 -0
  239. package/src/modules/toolbar/components/__tests__/AgentInstructionsCard.test.tsx +370 -0
  240. package/src/modules/toolbar/components/__tests__/ExternalAgentAccessPage.test.tsx +542 -42
  241. package/src/modules/toolbar/components/__tests__/Toolbar.test.tsx +2 -2
  242. package/src/modules/toolbar/components/__tests__/claude-setup-shots.test.ts +104 -0
  243. package/src/modules/toolbar/components/claude-connector-slide.tsx +38 -0
  244. package/src/modules/toolbar/components/claude-setup-shots.ts +167 -0
  245. package/src/modules/toolbar/components/deployment-address.ts +29 -0
  246. package/src/modules/toolbar/components/setup-step-parts.tsx +35 -0
  247. package/src/modules/toolbar/services/__tests__/agent-instructions.api.test.ts +89 -0
  248. package/src/modules/toolbar/services/agent-instructions.api.ts +167 -0
  249. package/src/modules/toolbar/services/external-api-keys.api.ts +6 -0
  250. package/src/modules/workflow/state/ChangeRequestStaleBinder.tsx +43 -0
  251. package/src/modules/workflow/state/EventBusProvider.tsx +122 -11
  252. package/src/modules/workflow/state/__tests__/EventBusProvider.storage.test.tsx +87 -0
  253. package/src/modules/workflow/state/__tests__/EventBusProvider.watch.test.tsx +223 -0
  254. package/src/modules/workflow/state/event-bus.context.ts +10 -0
  255. package/src/modules/workspace/__tests__/testFixtures.ts +5 -3
  256. package/src/modules/workspace/components/FileExplorer.tsx +1295 -191
  257. package/src/modules/workspace/components/FileRoute.tsx +353 -36
  258. package/src/modules/workspace/components/FileViewer.tsx +166 -45
  259. package/src/modules/workspace/components/KbDocumentShell.tsx +50 -6
  260. package/src/modules/workspace/components/KbPageHeader.tsx +120 -55
  261. package/src/modules/workspace/components/TreeActionConfirm.tsx +350 -0
  262. package/src/modules/workspace/components/__tests__/FileExplorer.test.tsx +2473 -129
  263. package/src/modules/workspace/components/__tests__/FileRoute.test.tsx +731 -18
  264. package/src/modules/workspace/components/__tests__/FileViewer.test.tsx +331 -12
  265. package/src/modules/workspace/components/__tests__/KbDocumentShell.test.tsx +39 -0
  266. package/src/modules/workspace/components/__tests__/KbPageHeader.test.tsx +33 -20
  267. package/src/modules/workspace/components/renderers/DocxRenderer.tsx +4 -5
  268. package/src/modules/workspace/components/renderers/DownloadFileButton.tsx +13 -4
  269. package/src/modules/workspace/components/renderers/EmailRenderer.tsx +4 -3
  270. package/src/modules/workspace/components/renderers/HtmlRenderer.tsx +8 -14
  271. package/src/modules/workspace/components/renderers/ImageRenderer.tsx +75 -16
  272. package/src/modules/workspace/components/renderers/KbImage.tsx +180 -0
  273. package/src/modules/workspace/components/renderers/KbMarkdownView.tsx +22 -6
  274. package/src/modules/workspace/components/renderers/MarkdownRenderer.tsx +48 -22
  275. package/src/modules/workspace/components/renderers/PdfRenderer.tsx +4 -5
  276. package/src/modules/workspace/components/renderers/PptxRenderer.tsx +4 -3
  277. package/src/modules/workspace/components/renderers/XlsxRenderer.tsx +4 -3
  278. package/src/modules/workspace/components/renderers/__tests__/DocxRenderer.test.tsx +12 -0
  279. package/src/modules/workspace/components/renderers/__tests__/DownloadFileButton.test.tsx +57 -9
  280. package/src/modules/workspace/components/renderers/__tests__/EmailRenderer.test.tsx +13 -1
  281. package/src/modules/workspace/components/renderers/__tests__/ImageRenderer.test.tsx +163 -0
  282. package/src/modules/workspace/components/renderers/__tests__/KbMarkdownView.test.tsx +237 -0
  283. package/src/modules/workspace/components/renderers/__tests__/MarkdownRenderer.test.tsx +108 -14
  284. package/src/modules/workspace/components/renderers/__tests__/PptxRenderer.test.tsx +14 -1
  285. package/src/modules/workspace/components/renderers/__tests__/XlsxRenderer.test.tsx +16 -1
  286. package/src/modules/workspace/components/renderers/__tests__/rendererSelection.test.tsx +66 -1
  287. package/src/modules/workspace/components/renderers/index.ts +53 -2
  288. package/src/modules/workspace/components/renderers/kbMarkdownPipeline.tsx +25 -4
  289. package/src/modules/workspace/components/renderers/rendererWorkspace.ts +40 -0
  290. package/src/modules/workspace/hooks/__tests__/useImageRevision.test.tsx +174 -0
  291. package/src/modules/workspace/hooks/__tests__/useOpenChangeRequests.test.tsx +179 -1
  292. package/src/modules/workspace/hooks/__tests__/useWorkspaceImageResolver.test.tsx +122 -0
  293. package/src/modules/workspace/hooks/__tests__/useWorkspaceState.test.tsx +892 -7
  294. package/src/modules/workspace/hooks/useImageRevision.ts +101 -0
  295. package/src/modules/workspace/hooks/useMergedWorkspaceTree.ts +22 -3
  296. package/src/modules/workspace/hooks/useWorkspaceImageResolver.ts +55 -0
  297. package/src/modules/workspace/hooks/useWorkspaceState.ts +424 -66
  298. package/src/modules/workspace/routing/__tests__/kb-routes.test.tsx +279 -3
  299. package/src/modules/workspace/routing/kb-routes.ts +206 -29
  300. package/src/modules/workspace/services/__tests__/workspace.api.test.ts +57 -1
  301. package/src/modules/workspace/services/workspace.api.ts +57 -4
  302. package/src/modules/workspace/state/__tests__/applied-request-clears-pending.test.tsx +343 -0
  303. package/src/modules/workspace/state/__tests__/upload-lands-where-it-was-dropped.test.tsx +158 -0
  304. package/src/modules/workspace/state/open-change-requests.tsx +100 -12
  305. package/src/modules/workspace/state/workspace.context.ts +125 -19
  306. package/src/modules/workspace/utils/__tests__/file-trace.test.ts +73 -0
  307. package/src/modules/workspace/utils/__tests__/fileTree.test.ts +220 -6
  308. package/src/modules/workspace/utils/__tests__/pasteLink.test.ts +76 -0
  309. package/src/modules/workspace/utils/__tests__/treeConfirm.test.ts +364 -0
  310. package/src/modules/workspace/utils/__tests__/uploadError.test.ts +35 -0
  311. package/src/modules/workspace/utils/file-trace.ts +50 -0
  312. package/src/modules/workspace/utils/fileTree.ts +112 -36
  313. package/src/modules/workspace/utils/frontmatter.ts +8 -4
  314. package/src/modules/workspace/utils/pasteLink.ts +90 -0
  315. package/src/modules/workspace/utils/treeConfirm.ts +338 -0
  316. package/src/modules/workspace/utils/uploadError.ts +29 -0
  317. package/src/shared/__tests__/marketplace-url.test.ts +6 -1
  318. package/src/shared/components/Button.tsx +16 -2
  319. package/src/shared/components/Dialog.tsx +27 -11
  320. package/src/shared/components/Menu.tsx +13 -1
  321. package/src/shared/components/PageShell.tsx +13 -8
  322. package/src/shared/components/__tests__/primitives.test.tsx +116 -2
  323. package/src/shared/components/__tests__/useFocusHandoff.test.tsx +192 -0
  324. package/src/shared/components/index.ts +2 -0
  325. package/src/shared/components/useDismissableMenu.ts +32 -10
  326. package/src/shared/components/useFocusHandoff.ts +51 -0
  327. package/src/shared/components/useLatestRef.ts +28 -0
  328. package/src/shared/markdown/Markdown.tsx +12 -3
  329. package/src/shared/markdown/__tests__/escapeSpacesInLinkDestinations.test.ts +39 -0
  330. package/src/shared/markdown/hrefs.ts +50 -0
  331. package/src/shared/marketplace-url.ts +33 -5
  332. package/src/shared/mcp/ChatGptInstallLink.tsx +3 -3
  333. package/src/shared/mcp/ConnectionInstructions.tsx +38 -27
  334. package/src/shared/mcp/__tests__/connect-snippets.test.ts +3 -3
  335. package/src/shared/mcp/connect-snippets.ts +14 -9
  336. package/src/shared/mcp/index.ts +1 -1
  337. package/src/shared/theme/__tests__/header-band.test.ts +197 -0
  338. package/src/shared/theme/header.ts +75 -0
  339. package/src/shared/theme/measure.ts +7 -4
  340. package/src/shared/theme/tokens.css +25 -0
  341. package/src/modules/library/__tests__/PluginsIndexPage.test.tsx +0 -363
  342. package/src/modules/library/__tests__/PluginsSidebar.locked.test.tsx +0 -97
  343. package/src/modules/library/components/PluginsIndexPage.tsx +0 -270
  344. package/src/modules/update-check/__tests__/UpdateBanner.test.tsx +0 -126
  345. package/src/modules/update-check/components/UpdateBanner.tsx +0 -92
  346. package/src/modules/update-check/services/update-check.api.ts +0 -24
@@ -7,14 +7,13 @@ import { makeWorkspaceFixture } from '../../../__tests__/testFixtures';
7
7
  import { GitContext, type GitContextValue } from '../../../../git/state/git.context';
8
8
  import { MarkdownRenderer } from '../MarkdownRenderer';
9
9
 
10
- // Capture navigation so we can assert link clicks resolve + open the right file.
11
- const navMock = vi.hoisted(() => ({ openFile: vi.fn() }));
12
- vi.mock('../../../routing/kb-routes', async (importActual) => ({
13
- // Keep the real `resolveRelativePath` (and any other pure helpers) so link
14
- // resolution is exercised for real; only the navigation hook is stubbed.
15
- ...(await importActual<typeof import('../../../routing/kb-routes')>()),
16
- useFileNav: () => ({ openFile: navMock.openFile }),
17
- KB_ROUTE_PREFIX: '/workspace',
10
+ // Capture navigation so we can assert link clicks resolve + open the right
11
+ // file. The router's `navigate` is stubbed rather than the nav hook, so the
12
+ // real resolution (`resolveKbHref` → `kbFileUrl`) is exercised end to end.
13
+ const navigateMock = vi.hoisted(() => vi.fn());
14
+ vi.mock('react-router-dom', async (importActual) => ({
15
+ ...(await importActual<typeof import('react-router-dom')>()),
16
+ useNavigate: () => navigateMock,
18
17
  }));
19
18
 
20
19
  function makeGit(): GitContextValue {
@@ -142,6 +141,58 @@ describe('MarkdownRenderer', () => {
142
141
  expect((screen.getByRole('textbox') as HTMLTextAreaElement).value).toBe('hello world');
143
142
  });
144
143
 
144
+ // --- Paste makes a link ---
145
+
146
+ function paste(textarea: HTMLElement, text: string) {
147
+ fireEvent.paste(textarea, { clipboardData: { getData: (type: string) => (type === 'text/plain' ? text : '') } });
148
+ }
149
+
150
+ function editorWith(value: string, selection: [number, number]) {
151
+ const onValueChange = vi.fn();
152
+ render(
153
+ <MemoryRouter>
154
+ <WorkspaceContext.Provider value={makeWorkspace()}>
155
+ <GitContext.Provider value={makeGit()}>
156
+ <MarkdownRenderer content={value} filePath="Knowledge/Foo.md" onSave={async () => {}} onValueChange={onValueChange} />
157
+ </GitContext.Provider>
158
+ </WorkspaceContext.Provider>
159
+ </MemoryRouter>,
160
+ );
161
+ const textarea = screen.getByRole('textbox') as HTMLTextAreaElement;
162
+ textarea.setSelectionRange(...selection);
163
+ return { textarea, onValueChange };
164
+ }
165
+
166
+ it('pasting a bare workspace path with no selection inserts a root-anchored link named after the file', () => {
167
+ const { textarea, onValueChange } = editorWith('See here', [4, 4]);
168
+ paste(textarea, '/knowledge-base/KnowledgeBase/File Type examples/subfile.md');
169
+ const expected = 'See [subfile](</knowledge-base/KnowledgeBase/File Type examples/subfile.md>) here';
170
+ expect(textarea.value).toBe(expected);
171
+ expect(onValueChange).toHaveBeenCalledWith(expected);
172
+ });
173
+
174
+ it('pasting a URL with no selection inserts a link labelled with host and path', () => {
175
+ const { textarea } = editorWith('', [0, 0]);
176
+ paste(textarea, 'https://example.com/docs/guide?x=1');
177
+ expect(textarea.value).toBe('[example.com/docs/guide](https://example.com/docs/guide?x=1)');
178
+ });
179
+
180
+ it('pasting with a selection makes the selection the label', () => {
181
+ const { textarea } = editorWith('read the guide now', [9, 14]);
182
+ paste(textarea, '/knowledge-base/Knowledge/Guide.md');
183
+ expect(textarea.value).toBe('read the [guide](/knowledge-base/Knowledge/Guide.md) now');
184
+ });
185
+
186
+ it('pasting ordinary text is left to the browser', () => {
187
+ const { textarea, onValueChange } = editorWith('hello', [5, 5]);
188
+ const event = new Event('paste', { bubbles: true, cancelable: true });
189
+ Object.assign(event, { clipboardData: { getData: () => 'just some words' } });
190
+ fireEvent(textarea, event);
191
+ expect(event.defaultPrevented).toBe(false);
192
+ expect(textarea.value).toBe('hello');
193
+ expect(onValueChange).not.toHaveBeenCalled();
194
+ });
195
+
145
196
  // --- Link rendering in preview (readOnly) mode ---
146
197
 
147
198
  function renderPreview(content: string, filePath: string) {
@@ -157,7 +208,7 @@ describe('MarkdownRenderer', () => {
157
208
  }
158
209
 
159
210
  it('renders a nodeType frontmatter value as a clickable link that navigates', async () => {
160
- navMock.openFile.mockClear();
211
+ navigateMock.mockClear();
161
212
  const user = userEvent.setup();
162
213
  renderPreview(
163
214
  '---\nnodeType: "[Process](../NodeTypes/Process.md)"\n---\n\n# Body',
@@ -165,25 +216,68 @@ describe('MarkdownRenderer', () => {
165
216
  );
166
217
  const link = screen.getByRole('link', { name: 'Process' });
167
218
  await user.click(link);
168
- expect(navMock.openFile).toHaveBeenCalledWith('Knowledge/NodeTypes/Process.md');
219
+ expect(navigateMock).toHaveBeenCalledWith('/workspace/alice%2Fdraft/Knowledge/NodeTypes/Process.md');
169
220
  });
170
221
 
171
222
  it('renders a bare body link whose path contains spaces as a working link', async () => {
172
- navMock.openFile.mockClear();
223
+ navigateMock.mockClear();
173
224
  const user = userEvent.setup();
174
225
  renderPreview('[Open](Some File.md)', 'Knowledge/Foo.md');
175
226
  const link = screen.getByRole('link', { name: 'Open' });
176
227
  await user.click(link);
177
- expect(navMock.openFile).toHaveBeenCalledWith('Knowledge/Some File.md');
228
+ expect(navigateMock).toHaveBeenCalledWith('/workspace/alice%2Fdraft/Knowledge/Some%20File.md');
178
229
  });
179
230
 
180
231
  it('renders an angle-bracketed body link with spaces as a working link', async () => {
181
- navMock.openFile.mockClear();
232
+ navigateMock.mockClear();
182
233
  const user = userEvent.setup();
183
234
  renderPreview('[Open](<Some File.md>)', 'Knowledge/Foo.md');
184
235
  const link = screen.getByRole('link', { name: 'Open' });
185
236
  await user.click(link);
186
- expect(navMock.openFile).toHaveBeenCalledWith('Knowledge/Some File.md');
237
+ expect(navigateMock).toHaveBeenCalledWith('/workspace/alice%2Fdraft/Knowledge/Some%20File.md');
238
+ });
239
+
240
+ // The link a paste wraps a Copy path in: root-anchored, so it opens the same
241
+ // file however deep the linking page sits.
242
+ it('opens a pasted root-anchored link from a file in a different folder', async () => {
243
+ navigateMock.mockClear();
244
+ const user = userEvent.setup();
245
+ renderPreview(
246
+ '[subfile](</knowledge-base/KnowledgeBase/File Type examples/subfile.md>)',
247
+ 'knowledge-base/KnowledgeBase/Other/Deep/parent.md',
248
+ );
249
+ await user.click(screen.getByRole('link', { name: 'subfile' }));
250
+ expect(navigateMock).toHaveBeenCalledWith(
251
+ '/workspace/alice%2Fdraft/knowledge-base/KnowledgeBase/File%20Type%20examples/subfile.md',
252
+ );
253
+ });
254
+
255
+ it('keeps the branch of an absolute citation URL instead of resolving it against the file', async () => {
256
+ navigateMock.mockClear();
257
+ const user = userEvent.setup();
258
+ renderPreview('[Cited](/workspace/target-company-state/knowledge-base/GTM/Bundle.md#status)', 'Knowledge/Foo.md');
259
+ await user.click(screen.getByRole('link', { name: 'Cited' }));
260
+ expect(navigateMock).toHaveBeenCalledWith(
261
+ '/workspace/target-company-state/knowledge-base/GTM/Bundle.md#status',
262
+ );
263
+ });
264
+
265
+ // --- Images in preview mode ---
266
+
267
+ it('serves a relative image from the raw file route of the current workspace, resolved against the file', () => {
268
+ renderPreview('![Shot](./assets/shot.png)', 'Knowledge/Sub/Foo.md');
269
+ expect(screen.getByRole('img', { name: 'Shot' })).toHaveAttribute(
270
+ 'src',
271
+ '/api/workspace/ws-1/file/raw?path=Knowledge%2FSub%2Fassets%2Fshot.png',
272
+ );
273
+ });
274
+
275
+ it('serves an absolute workspace image URL by its path, from the current workspace (the branch rule)', () => {
276
+ renderPreview('![Shot](/workspace/other-branch/knowledge-base/assets/shot.png)', 'Knowledge/Foo.md');
277
+ expect(screen.getByRole('img', { name: 'Shot' })).toHaveAttribute(
278
+ 'src',
279
+ '/api/workspace/ws-1/file/raw?path=knowledge-base%2Fassets%2Fshot.png',
280
+ );
187
281
  });
188
282
 
189
283
  // --- Background autosave must not disturb the editing UI (BEVA ticket) ---
@@ -1,5 +1,5 @@
1
1
  import { describe, it, expect, vi, beforeEach } from 'vitest';
2
- import { render, screen, within } from '@testing-library/react';
2
+ import { render, screen, within, waitFor } from '@testing-library/react';
3
3
  import JSZip from 'jszip';
4
4
  import {
5
5
  WorkspaceContext,
@@ -123,3 +123,16 @@ describe('PptxRenderer', () => {
123
123
  ).toBeInTheDocument();
124
124
  });
125
125
  });
126
+
127
+ /** The URL the viewer asks for is the raw file route, built by `rawFileUrl`. */
128
+ describe('PptxRenderer fetch', () => {
129
+ it('asks the raw file route for exactly this file', async () => {
130
+ const bytes = await deckBytes();
131
+ apiMock.authFetch.mockResolvedValue({ ok: true, arrayBuffer: async () => bytes });
132
+ renderPptx();
133
+ await waitFor(() => expect(apiMock.authFetch).toHaveBeenCalled());
134
+ expect(apiMock.authFetch.mock.calls[0][0]).toBe(
135
+ '/api/workspace/ws-1/file/raw?path=Inbox%2Fall-hands.pptx',
136
+ );
137
+ });
138
+ });
@@ -1,5 +1,5 @@
1
1
  import { describe, it, expect, vi, beforeEach } from 'vitest';
2
- import { render, screen } from '@testing-library/react';
2
+ import { render, screen, waitFor } from '@testing-library/react';
3
3
  import JSZip from 'jszip';
4
4
  import * as XLSX from 'xlsx';
5
5
  import {
@@ -243,3 +243,18 @@ describe('XlsxRenderer truncation', () => {
243
243
  expect(screen.getByRole('button', { name: /Download/ })).toBeInTheDocument();
244
244
  });
245
245
  });
246
+
247
+ /** The URL the viewer asks for is the raw file route, built by `rawFileUrl`. */
248
+ describe('XlsxRenderer fetch', () => {
249
+ it('asks the raw file route for exactly this file', async () => {
250
+ apiMock.authFetch.mockResolvedValue({
251
+ ok: true,
252
+ arrayBuffer: async () => workbookBytes([['id'], ['r1']]),
253
+ });
254
+ renderXlsx();
255
+ await waitFor(() => expect(apiMock.authFetch).toHaveBeenCalled());
256
+ expect(apiMock.authFetch.mock.calls[0][0]).toBe(
257
+ '/api/workspace/ws-1/file/raw?path=Data%2Fbook.xlsx',
258
+ );
259
+ });
260
+ });
@@ -8,7 +8,7 @@ import {
8
8
  const apiMock = vi.hoisted(() => ({ authFetch: vi.fn() }));
9
9
  vi.mock('../../../../../lib/api', () => ({ authFetch: apiMock.authFetch }));
10
10
 
11
- import { getFileRenderer } from '../index';
11
+ import { getFileRenderer, hasFileViewer, rendersAsText } from '../index';
12
12
  import { LegacyOfficeRenderer } from '../LegacyOfficeRenderer';
13
13
  import { TextRenderer } from '../TextRenderer';
14
14
  import { ImageRenderer } from '../ImageRenderer';
@@ -60,6 +60,71 @@ describe('getFileRenderer: document routing', () => {
60
60
  expect(getFileRenderer('notes/scratch.unknown')).toBe(TextRenderer);
61
61
  expect(getFileRenderer('pics/logo.png')).toBe(ImageRenderer);
62
62
  });
63
+
64
+ it('shows an access.md as the YAML it is — its `#` explanations are comments, not headings', () => {
65
+ expect(getFileRenderer('access.md')).toBe(TextRenderer);
66
+ expect(getFileRenderer('Plugins/GTM/access.md')).toBe(TextRenderer);
67
+ expect(getFileRenderer('Plugins/GTM/ACCESS.MD')).toBe(TextRenderer);
68
+ // Only the rules file: any other markdown stays a document.
69
+ expect(rendererName(getFileRenderer('Plugins/GTM/README.md'))).toBe('MarkdownRenderer');
70
+ });
71
+ });
72
+
73
+ /**
74
+ * The question the change-request dialog asks before offering to show a
75
+ * proposed document: is there a viewer for this, or only a sentence about it?
76
+ * Derived from the routing above, so the two can't drift.
77
+ */
78
+ describe('hasFileViewer', () => {
79
+ it.each([
80
+ 'Inbox/brief.pdf',
81
+ 'Inbox/report.docx',
82
+ 'Data/book.xlsx',
83
+ 'Inbox/all-hands.pptx',
84
+ 'Inbox/offer.eml',
85
+ 'Inbox/thread.msg',
86
+ 'pics/logo.png',
87
+ 'pics/diagram.svg',
88
+ 'Data/rows.csv',
89
+ ])('%s has a viewer', (path) => {
90
+ expect(hasFileViewer(path)).toBe(true);
91
+ });
92
+
93
+ it.each([
94
+ // The no-preview note is not a viewer — it renders nothing of the file.
95
+ 'old/memo.doc',
96
+ 'old/deck.ppt',
97
+ 'old/sheet.xls',
98
+ 'docs/spec.odt',
99
+ 'decks/pitch.odp',
100
+ 'data/numbers.ods',
101
+ // The text fallback over bytes nobody can read as text.
102
+ 'archive/bundle.zip',
103
+ 'notes/scratch.unknown',
104
+ ])('%s has none', (path) => {
105
+ expect(hasFileViewer(path)).toBe(false);
106
+ });
107
+ });
108
+
109
+ /**
110
+ * `rendersAsText` answers for names the registry ROUTES to `TextRenderer`,
111
+ * not for everything the text fallback happens to catch.
112
+ */
113
+ describe('rendersAsText', () => {
114
+ it.each(['access.md', 'Teams/Eng/Access.md'])('%s is routed to text', (path) => {
115
+ expect(rendersAsText(path)).toBe(true);
116
+ });
117
+
118
+ it.each([
119
+ // An ordinary document.
120
+ 'notes/readme.md',
121
+ // The text fallback over bytes nobody can read as text.
122
+ 'archive/bundle.zip',
123
+ 'blobs/unknown.bin',
124
+ 'notes/scratch.unknown',
125
+ ])('%s is not', (path) => {
126
+ expect(rendersAsText(path)).toBe(false);
127
+ });
63
128
  });
64
129
 
65
130
  describe('LegacyOfficeRenderer', () => {
@@ -10,6 +10,7 @@ import { LegacyOfficeRenderer } from './LegacyOfficeRenderer';
10
10
  import { lazyRenderer } from './lazyRenderer';
11
11
 
12
12
  export type { FileRendererProps, RendererSaveState } from './types';
13
+ export { RendererWorkspaceContext, useRendererWorkspaceId } from './rendererWorkspace';
13
14
 
14
15
  /**
15
16
  * The document viewers are code-split: their parsers (xlsx ~141 KB gzip,
@@ -81,9 +82,59 @@ const renderersByExtension: Record<string, ComponentType<FileRendererProps>> = {
81
82
 
82
83
  const fallbackRenderer = TextRenderer;
83
84
 
84
- export function getFileRenderer(filePath: string): ComponentType<FileRendererProps> {
85
+ /**
86
+ * The access rules file is YAML with `#` explanations, not a document: the
87
+ * markdown renderer turned every comment line into a heading and hid the
88
+ * rules it explains. Shown as the text it is — the same text an agent reads.
89
+ */
90
+ const ACCESS_RULES_FILE = 'access.md';
91
+
92
+ /** The renderer the registry routes this file to; `undefined` when only the fallback would take it. */
93
+ function mappedRenderer(filePath: string): ComponentType<FileRendererProps> | undefined {
94
+ const name = filePath.slice(filePath.lastIndexOf('/') + 1).toLowerCase();
95
+ if (name === ACCESS_RULES_FILE) return TextRenderer;
85
96
  const ext = filePath.slice(filePath.lastIndexOf('.')).toLowerCase();
86
- return renderersByExtension[ext] ?? fallbackRenderer;
97
+ return renderersByExtension[ext];
98
+ }
99
+
100
+ export function getFileRenderer(filePath: string): ComponentType<FileRendererProps> {
101
+ return mappedRenderer(filePath) ?? fallbackRenderer;
102
+ }
103
+
104
+ /**
105
+ * Does the file page show this file as plain text?
106
+ *
107
+ * The change-request dialog asks this before rendering a `.md` as a document:
108
+ * a name the registry above sends to `TextRenderer` (the access rules file) is
109
+ * YAML that happens to end in `.md`, and a Markdown diff would turn its `#`
110
+ * comments into headings there just as the renderer used to here.
111
+ *
112
+ * Only a name the registry routes to `TextRenderer` counts — never the
113
+ * fallback, which lands on the same component but catches unknown and binary
114
+ * extensions (a `.zip`, a `.bin`) whose bytes are not text.
115
+ */
116
+ export function rendersAsText(filePath: string): boolean {
117
+ return mappedRenderer(filePath) === TextRenderer;
118
+ }
119
+
120
+ /**
121
+ * Does this file get a real VIEWER — a renderer that fetches the file and
122
+ * shows it — as opposed to the text fallback or the no-preview note?
123
+ *
124
+ * Derived from the registry rather than kept as a second list, so a renderer
125
+ * added (or removed) above answers here on the same day. The two negatives
126
+ * are the whole definition: `TextRenderer` is the fallback for anything
127
+ * unmapped (a `.zip`, an unknown binary — bytes nobody can read as text), and
128
+ * `LegacyOfficeRenderer` renders nothing at all, it is a sentence and a
129
+ * Download.
130
+ *
131
+ * The change-request dialog asks this before offering to show a proposed
132
+ * document: with a viewer it mounts the same one the file page uses; without
133
+ * one it keeps its note and offers the bytes.
134
+ */
135
+ export function hasFileViewer(filePath: string): boolean {
136
+ const renderer = getFileRenderer(filePath);
137
+ return renderer !== fallbackRenderer && renderer !== LegacyOfficeRenderer;
87
138
  }
88
139
 
89
140
  /**
@@ -26,9 +26,10 @@
26
26
  * So the diff viewer keeps its own block grouping, frontmatter panel and
27
27
  * `prose` wrapper, and consumes only the parts below.
28
28
  *
29
- * NAVIGATION IS INJECTED, NEVER LOOKED UP. Nothing here calls a hook that
30
- * needs Git/Workspace context or a Router. That is load-bearing in two
31
- * directions: it keeps the diff viewer mountable from the enterprise `/embed*`
29
+ * NAVIGATION IS INJECTED, NEVER LOOKED UP, and so is image resolution. Nothing
30
+ * here calls a hook that needs Git/Workspace context or a Router. That is
31
+ * load-bearing in two directions: it keeps the diff viewer mountable from the
32
+ * enterprise `/embed*`
32
33
  * routes, which render outside those providers, and it keeps the existing
33
34
  * change-request and file-history tests — which render bare, with no Router —
34
35
  * passing without acquiring provider wrappers.
@@ -42,6 +43,9 @@ import rehypeRaw from 'rehype-raw';
42
43
  import rehypeSanitize from 'rehype-sanitize';
43
44
  import rehypeSlug from 'rehype-slug';
44
45
  import { CopyAnchorButton } from './CopyAnchorButton';
46
+ import { KbImage, type KbImageResolver } from './KbImage';
47
+
48
+ export type { KbImageResolver, KbImageSource } from './KbImage';
45
49
 
46
50
  /**
47
51
  * Mermaid's eager core is ~151 KB gzip and is only needed by documents that
@@ -121,6 +125,13 @@ export interface KbMarkdownComponentOptions {
121
125
  * block, parse fine, and still render as diagrams.
122
126
  */
123
127
  onMermaidError?: 'error' | 'source';
128
+ /**
129
+ * Resolves a workspace image `src` to a URL the browser can load, or to the
130
+ * reason it will not be loaded. Omitted (the embed) → images render as plain
131
+ * `<img>` tags, as they always did. External `http(s)` and `//` sources
132
+ * never reach it. See {@link KbImage} for every state.
133
+ */
134
+ resolveImage?: KbImageResolver;
124
135
  }
125
136
 
126
137
  /**
@@ -132,6 +143,7 @@ export function useKbMarkdownComponents({
132
143
  onOpenNodeId,
133
144
  headingLink,
134
145
  onMermaidError = 'error',
146
+ resolveImage,
135
147
  }: KbMarkdownComponentOptions) {
136
148
  return useMemo(() => {
137
149
  // One renderer for h1–h6: reads its level from the hast node's tagName,
@@ -215,6 +227,15 @@ export function useKbMarkdownComponents({
215
227
  }
216
228
  return <a href={href} {...props}>{children}</a>;
217
229
  },
230
+ // Every image, whether from `![alt](src)` or an inline `<img>` that
231
+ // rehype-raw parsed, goes through `KbImage` and the injected resolver,
232
+ // with every attribute the sanitizer let through. Only the hast `node`
233
+ // is dropped, so it never lands on the element as `node="[object Object]"`.
234
+ img(props: React.ImgHTMLAttributes<HTMLImageElement> & { node?: unknown }) {
235
+ const attributes = { ...props };
236
+ delete attributes.node;
237
+ return <KbImage {...attributes} resolve={resolveImage} />;
238
+ },
218
239
  pre({ node: _node, children, ...props }: { node?: unknown; children?: React.ReactNode }) {
219
240
  // Render a mermaid code block as a diagram.
220
241
  const child = Array.isArray(children) ? children[0] : children;
@@ -237,5 +258,5 @@ export function useKbMarkdownComponents({
237
258
  return <pre {...props}>{children}</pre>;
238
259
  },
239
260
  };
240
- }, [onOpenFile, onOpenNodeId, headingLink, onMermaidError]);
261
+ }, [onOpenFile, onOpenNodeId, headingLink, onMermaidError, resolveImage]);
241
262
  }
@@ -0,0 +1,40 @@
1
+ import { createContext, useContext } from 'react';
2
+ import { WorkspaceContext } from '../../state/workspace.context';
3
+
4
+ /**
5
+ * The workspace a renderer should fetch its bytes from, when that is NOT the
6
+ * workspace the app has checked out.
7
+ *
8
+ * Every viewer here reads the file itself — `rawFileUrl(workspaceId, path)` —
9
+ * rather than the text buffer, and until now `workspaceId` could only be the
10
+ * one the user is browsing. The change-request dialog needs the same viewers
11
+ * pointed at a DIFFERENT branch's workspace (the request's), so it provides
12
+ * this override around them.
13
+ *
14
+ * A narrow context on purpose: `workspaceId` is the only thing any renderer
15
+ * takes from the workspace, and standing up a whole `WorkspaceContextValue`
16
+ * (forty methods that mutate a working tree the dialog must never touch) to
17
+ * pass one string would be a lie about what the pane can do.
18
+ */
19
+ export const RendererWorkspaceContext = createContext<{ workspaceId: string | null } | null>(
20
+ null,
21
+ );
22
+
23
+ /**
24
+ * The workspace id the renderer should read from: the override when one is
25
+ * provided, otherwise the checked-out workspace.
26
+ *
27
+ * Throws when neither is present, exactly as `useWorkspace()` did — a renderer
28
+ * with no workspace at all would otherwise sit on "Loading…" forever.
29
+ */
30
+ export function useRendererWorkspaceId(): string | null {
31
+ const override = useContext(RendererWorkspaceContext);
32
+ const workspace = useContext(WorkspaceContext);
33
+ if (override !== null) return override.workspaceId;
34
+ if (workspace === null) {
35
+ throw new Error(
36
+ 'useRendererWorkspaceId must be used within WorkspaceContext.Provider or RendererWorkspaceContext.Provider',
37
+ );
38
+ }
39
+ return workspace.workspaceId;
40
+ }
@@ -0,0 +1,174 @@
1
+ import { describe, it, expect } from 'vitest';
2
+ import { act, renderHook } from '@testing-library/react';
3
+ import type { ReactNode } from 'react';
4
+ import type { WorkflowEvent } from '@bevel-software/platform-shared';
5
+ import { EventBusContext, type EventBusContextValue } from '../../../workflow/state/event-bus.context';
6
+ import { useImageRevision, isImagePath } from '../useImageRevision';
7
+
8
+ function makeFakeBus() {
9
+ const handlers: Record<string, ((e: WorkflowEvent) => void)[]> = {};
10
+ // The workspaces the hook has ASKED to be delivered. Without a watch the
11
+ // real stream sends nothing for a workspace the session isn't focused on,
12
+ // so "did it subscribe" and "will anything arrive" are separate facts and
13
+ // the fake tracks both.
14
+ const watched: string[] = [];
15
+ const bus: EventBusContextValue & { emit(e: WorkflowEvent): void; watched: string[] } = {
16
+ subscribe(kind, handler) {
17
+ (handlers[kind] ??= []).push(handler as (e: WorkflowEvent) => void);
18
+ return () => {
19
+ handlers[kind] = (handlers[kind] ?? []).filter((h) => h !== handler);
20
+ };
21
+ },
22
+ setFocus() {},
23
+ watchWorkspace(workspaceId) {
24
+ watched.push(workspaceId);
25
+ return () => {
26
+ const at = watched.indexOf(workspaceId);
27
+ if (at >= 0) watched.splice(at, 1);
28
+ };
29
+ },
30
+ watched,
31
+ emit(e) {
32
+ (handlers[e.kind] ?? []).forEach((h) => h(e));
33
+ },
34
+ };
35
+ return bus;
36
+ }
37
+
38
+ function fileChanged(workspaceId: string, path: string): WorkflowEvent {
39
+ return {
40
+ kind: 'file-changed',
41
+ workspaceId,
42
+ branch: workspaceId,
43
+ path,
44
+ newSha: 'abc123',
45
+ } as unknown as WorkflowEvent;
46
+ }
47
+
48
+ function treeChanged(workspaceId: string): WorkflowEvent {
49
+ return { kind: 'fs-tree-changed', workspaceId, branch: workspaceId } as unknown as WorkflowEvent;
50
+ }
51
+
52
+ function renderRevision(bus: ReturnType<typeof makeFakeBus>, workspaceId: string | null) {
53
+ return renderHook(({ ws }: { ws: string | null }) => useImageRevision(ws), {
54
+ initialProps: { ws: workspaceId },
55
+ wrapper: ({ children }: { children: ReactNode }) => (
56
+ <EventBusContext.Provider value={bus}>{children}</EventBusContext.Provider>
57
+ ),
58
+ });
59
+ }
60
+
61
+ describe('useImageRevision', () => {
62
+ it('starts at 0, so an image URL stays cacheable until something changes', () => {
63
+ const { result } = renderRevision(makeFakeBus(), 'ws-1');
64
+ expect(result.current).toBe(0);
65
+ });
66
+
67
+ it('bumps when an image in the workspace changes', () => {
68
+ const bus = makeFakeBus();
69
+ const { result } = renderRevision(bus, 'ws-1');
70
+ act(() => bus.emit(fileChanged('ws-1', 'knowledge-base/assets/shot.png')));
71
+ expect(result.current).toBe(1);
72
+ act(() => bus.emit(fileChanged('ws-1', 'knowledge-base/assets/other.png')));
73
+ expect(result.current).toBe(2);
74
+ });
75
+
76
+ // Local state holds the URL-encoded branch, the event the decoded one; a
77
+ // branch with a `/` in its name must still match (see canonicalizeWorkspaceId).
78
+ it('matches the event workspace to the subscribed one across encodings', () => {
79
+ const bus = makeFakeBus();
80
+ const { result } = renderRevision(bus, 'alice%2Fdraft');
81
+ act(() => bus.emit(fileChanged('alice/draft', 'KB/a.png')));
82
+ expect(result.current).toBe(1);
83
+ });
84
+
85
+ it("ignores another workspace's event", () => {
86
+ const bus = makeFakeBus();
87
+ const { result } = renderRevision(bus, 'ws-1');
88
+ act(() => bus.emit(fileChanged('ws-2', 'KB/a.png')));
89
+ expect(result.current).toBe(0);
90
+ });
91
+
92
+ it("ignores a text file: a document re-read is the workspace hook's job, and must not revalidate every screenshot", () => {
93
+ const bus = makeFakeBus();
94
+ const { result } = renderRevision(bus, 'ws-1');
95
+ act(() => bus.emit(fileChanged('ws-1', 'KB/Node.md')));
96
+ expect(result.current).toBe(0);
97
+ });
98
+
99
+ // The backend emits a tree change after EVERY write, text or image, and
100
+ // names no file in it; the paths a bulk change touched arrive as per-file
101
+ // events of their own. Counting the tree event would revalidate every
102
+ // screenshot on each text save and bump twice on an image save.
103
+ it('ignores a tree change: the per-file events already name every image that changed', () => {
104
+ const bus = makeFakeBus();
105
+ const { result } = renderRevision(bus, 'ws-1');
106
+ act(() => bus.emit(treeChanged('ws-1')));
107
+ expect(result.current).toBe(0);
108
+ act(() => {
109
+ bus.emit(fileChanged('ws-1', 'KB/assets/shot.png'));
110
+ bus.emit(treeChanged('ws-1'));
111
+ });
112
+ expect(result.current).toBe(1);
113
+ });
114
+
115
+ // A count carried across a switch would be a number about a different tree.
116
+ it('starts over on a workspace switch, in both directions', () => {
117
+ const bus = makeFakeBus();
118
+ const { result, rerender } = renderRevision(bus, 'ws-1');
119
+ act(() => bus.emit(fileChanged('ws-1', 'KB/a.png')));
120
+ expect(result.current).toBe(1);
121
+ rerender({ ws: 'ws-2' });
122
+ expect(result.current).toBe(0);
123
+ act(() => bus.emit(fileChanged('ws-2', 'KB/a.png')));
124
+ expect(result.current).toBe(1);
125
+ rerender({ ws: 'ws-1' });
126
+ expect(result.current).toBe(0);
127
+ });
128
+
129
+ it('counts nothing without a workspace or a bus', () => {
130
+ const bus = makeFakeBus();
131
+ const { result } = renderRevision(bus, null);
132
+ act(() => bus.emit(fileChanged('ws-1', 'KB/a.png')));
133
+ expect(result.current).toBe(0);
134
+ const bare = renderHook(() => useImageRevision('ws-1'));
135
+ expect(bare.result.current).toBe(0);
136
+ });
137
+
138
+ // The stream delivers workspace-scoped events only for the workspaces the
139
+ // session declared, and the focus binder declares one: the branch in the
140
+ // address bar. A hook counting events for ANY other workspace — the skill
141
+ // page renders the default branch's images from whatever branch you are
142
+ // standing on — counts an event that never arrives unless it asks.
143
+ it('watches the workspace it counts for, so events reach it off the focused branch', () => {
144
+ const bus = makeFakeBus();
145
+ const { unmount } = renderRevision(bus, 'main');
146
+ expect(bus.watched).toEqual(['main']);
147
+ unmount();
148
+ expect(bus.watched).toEqual([]);
149
+ });
150
+
151
+ it('moves the watch with the workspace, leaving nothing behind', () => {
152
+ const bus = makeFakeBus();
153
+ const { rerender } = renderRevision(bus, 'ws-1');
154
+ rerender({ ws: 'ws-2' });
155
+ expect(bus.watched).toEqual(['ws-2']);
156
+ });
157
+
158
+ it('watches nothing without a workspace', () => {
159
+ const bus = makeFakeBus();
160
+ renderRevision(bus, null);
161
+ expect(bus.watched).toEqual([]);
162
+ });
163
+ });
164
+
165
+ describe('isImagePath', () => {
166
+ it('recognises the extensions the raw route serves as pictures, case-insensitively', () => {
167
+ expect(isImagePath('a/b.PNG')).toBe(true);
168
+ expect(isImagePath('a/b.jpeg')).toBe(true);
169
+ expect(isImagePath('a/b.svg')).toBe(true);
170
+ expect(isImagePath('a/b.md')).toBe(false);
171
+ expect(isImagePath('a/b.pdf')).toBe(false);
172
+ expect(isImagePath('noext')).toBe(false);
173
+ });
174
+ });