@kabmo-labs/kabmo 0.8.0 → 0.10.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 (391) hide show
  1. package/README.md +52 -0
  2. package/dist/client/index.html +1 -1
  3. package/dist/client/index.js +336 -336
  4. package/dist/client/static/js/index-18xe7655.css +1 -0
  5. package/dist/client/static/js/{index-qwpvd9fv.js → index-nxpe7835.js} +933 -898
  6. package/package.json +11 -1
  7. package/src/client/components/common/code-surface/bracket-guide.test.ts +249 -0
  8. package/src/client/components/common/code-surface/bracket-guide.ts +131 -0
  9. package/src/client/components/common/code-surface/documents.test.ts +122 -0
  10. package/src/client/components/common/code-surface/documents.ts +286 -0
  11. package/src/client/components/common/code-surface/extensions.test.ts +115 -0
  12. package/src/client/components/common/code-surface/extensions.ts +295 -0
  13. package/src/client/components/common/code-surface/fold-stack.test.ts +218 -0
  14. package/src/client/components/common/code-surface/fold.test.ts +148 -0
  15. package/src/client/components/common/code-surface/fold.ts +118 -0
  16. package/src/client/components/common/code-surface/handle.ts +102 -0
  17. package/src/client/components/common/code-surface/indent-guide.ts +104 -0
  18. package/src/client/components/common/code-surface/indent.test.ts +239 -0
  19. package/src/client/components/common/code-surface/indent.ts +124 -0
  20. package/src/client/components/common/code-surface/index.tsx +283 -314
  21. package/src/client/components/common/code-surface/keymap.test.ts +133 -0
  22. package/src/client/components/common/code-surface/keymap.ts +256 -0
  23. package/src/client/components/common/code-surface/line-commands.test.ts +90 -0
  24. package/src/client/components/common/code-surface/line-commands.ts +103 -0
  25. package/src/client/components/common/code-surface/marks.ts +74 -0
  26. package/src/client/components/common/code-surface/props.ts +87 -0
  27. package/src/client/components/common/code-surface/shiki.ts +234 -0
  28. package/src/client/components/common/code-surface/stream-language.test.ts +118 -0
  29. package/src/client/components/common/code-surface/stream-language.ts +123 -0
  30. package/src/client/components/common/code-surface/sync.test.ts +185 -0
  31. package/src/client/components/common/code-surface/sync.ts +58 -0
  32. package/src/client/components/common/code-surface/theme.test.ts +237 -0
  33. package/src/client/components/common/code-surface/theme.ts +224 -0
  34. package/src/client/components/common/code-surface/typing.test.ts +97 -0
  35. package/src/client/components/common/code-surface/typing.ts +111 -0
  36. package/src/client/components/common/editor-view-buttons/index.test.tsx +148 -0
  37. package/src/client/components/common/editor-view-buttons/index.tsx +109 -0
  38. package/src/client/components/common/shell-update-button/Modal.tsx +163 -0
  39. package/src/client/components/common/shell-update-button/index.test.tsx +251 -0
  40. package/src/client/components/common/shell-update-button/index.tsx +125 -0
  41. package/src/client/components/common/toolbar-row/index.test.tsx +215 -0
  42. package/src/client/components/common/toolbar-row/index.tsx +260 -0
  43. package/src/client/components/layout/desktop-layout/WorkspacePanels.tsx +58 -78
  44. package/src/client/components/layout/desktop-layout/index.tsx +65 -67
  45. package/src/client/components/layout/desktop-layout/resizer/index.tsx +6 -3
  46. package/src/client/components/layout/session-sidebar/Footer.tsx +8 -15
  47. package/src/client/components/mobile/LayoutWrapper.tsx +1 -0
  48. package/src/client/components/mobile/mobile-right-sidebar/FullDiff.tsx +3 -0
  49. package/src/client/components/mobile/mobile-right-sidebar/FullEditor.tsx +98 -71
  50. package/src/client/components/mobile/mobile-right-sidebar/Header.tsx +20 -1
  51. package/src/client/components/mobile/mobile-right-sidebar/OutlineButton.test.tsx +137 -0
  52. package/src/client/components/mobile/mobile-right-sidebar/OutlineButton.tsx +14 -3
  53. package/src/client/components/mobile/mobile-right-sidebar/editor-props.ts +25 -0
  54. package/src/client/components/mobile/mobile-session-sidebar/Footer.tsx +9 -21
  55. package/src/client/components/settings/Modal.tsx +8 -0
  56. package/src/client/components/settings/categories/AppearanceSettings.tsx +9 -0
  57. package/src/client/components/settings/categories/appearance-settings/EditorIndentSection.tsx +87 -0
  58. package/src/client/components/settings/categories/appearance-settings/EditorThemeSection.test.tsx +167 -0
  59. package/src/client/components/settings/categories/appearance-settings/EditorThemeSection.tsx +184 -0
  60. package/src/client/components/settings/categories/appearance-settings/EditorTypingSection.tsx +99 -0
  61. package/src/client/components/settings/categories/project-settings/WorktreeSettings.tsx +8 -2
  62. package/src/client/components/workspace/chat-timeline/EmptyWorkspacePrompt.tsx +16 -8
  63. package/src/client/components/workspace/chat-timeline/SystemNotice.tsx +9 -4
  64. package/src/client/components/workspace/chat-timeline/TaskResultContent.tsx +9 -7
  65. package/src/client/components/workspace/chat-timeline/chat-input/expansion.ts +9 -4
  66. package/src/client/components/workspace/chat-timeline/chat-input/index.tsx +15 -11
  67. package/src/client/components/workspace/chat-timeline/chat-input/stretch-send.test.tsx +165 -0
  68. package/src/client/components/workspace/chat-timeline/target-picker/WorkspacePicker.test.tsx +132 -0
  69. package/src/client/components/workspace/chat-timeline/target-picker/WorkspacePicker.tsx +120 -0
  70. package/src/client/components/workspace/chat-timeline/target-picker/WorktreePicker.test.tsx +319 -0
  71. package/src/client/components/workspace/chat-timeline/target-picker/WorktreePicker.tsx +285 -0
  72. package/src/client/components/workspace/chat-timeline/tool-renderers/ask-panel/index.test.ts +2 -0
  73. package/src/client/components/workspace/chat-timeline/tool-renderers/hashline-patch/index.tsx +34 -29
  74. package/src/client/components/workspace/chat-timeline/tool-renderers/panels/AstEdit.tsx +11 -9
  75. package/src/client/components/workspace/chat-timeline/tool-renderers/panels/Bash.tsx +10 -7
  76. package/src/client/components/workspace/chat-timeline/tool-renderers/panels/Edit.tsx +25 -8
  77. package/src/client/components/workspace/chat-timeline/tool-renderers/panels/Eval.tsx +8 -11
  78. package/src/client/components/workspace/chat-timeline/tool-renderers/panels/FileMatches.test.ts +114 -0
  79. package/src/client/components/workspace/chat-timeline/tool-renderers/panels/FileMatches.tsx +111 -0
  80. package/src/client/components/workspace/chat-timeline/tool-renderers/panels/Read.tsx +7 -7
  81. package/src/client/components/workspace/chat-timeline/tool-renderers/panels/SearchTool.tsx +9 -59
  82. package/src/client/components/workspace/chat-timeline/tool-renderers/shared/ArtifactBody.tsx +2 -7
  83. package/src/client/components/workspace/chat-timeline/tool-renderers/shared/DiffView.test.ts +43 -30
  84. package/src/client/components/workspace/chat-timeline/tool-renderers/shared/DiffView.tsx +49 -32
  85. package/src/client/components/workspace/chat-timeline/tool-renderers/shared/ExcerptCode.tsx +8 -8
  86. package/src/client/components/workspace/chat-timeline/tool-renderers/shared/HighlightedCode.tsx +35 -0
  87. package/src/client/components/workspace/chat-timeline/tool-renderers/shared/JsonCodeBlock.tsx +4 -4
  88. package/src/client/components/workspace/diff-panel/MergeDiffView.tsx +179 -0
  89. package/src/client/components/workspace/diff-panel/ThemedMergeDiffView.tsx +24 -0
  90. package/src/client/components/workspace/diff-panel/Toolbar.tsx +224 -186
  91. package/src/client/components/workspace/diff-panel/ToolbarSegments.tsx +98 -0
  92. package/src/client/components/workspace/diff-panel/index.tsx +76 -145
  93. package/src/client/components/workspace/diff-panel/merge.ts +315 -0
  94. package/src/client/components/workspace/editor/Body.tsx +28 -7
  95. package/src/client/components/workspace/editor/CommandPalette.tsx +6 -6
  96. package/src/client/components/workspace/editor/ConflictStrip.tsx +77 -0
  97. package/src/client/components/workspace/editor/Dialogs.tsx +53 -0
  98. package/src/client/components/workspace/editor/EmptyEditor.tsx +23 -0
  99. package/src/client/components/workspace/editor/ExternalChangeStrip.tsx +61 -0
  100. package/src/client/components/workspace/editor/FileDocument.tsx +146 -63
  101. package/src/client/components/workspace/editor/FilePane.tsx +47 -7
  102. package/src/client/components/workspace/editor/FindWidget.test.ts +9 -5
  103. package/src/client/components/workspace/editor/FindWidget.tsx +36 -2
  104. package/src/client/components/workspace/editor/GoToLineModal.tsx +123 -0
  105. package/src/client/components/workspace/editor/Notices.tsx +71 -0
  106. package/src/client/components/workspace/editor/Pane.tsx +118 -0
  107. package/src/client/components/workspace/editor/PluginColumn.tsx +32 -0
  108. package/src/client/components/workspace/editor/QuickOpenModal.tsx +146 -0
  109. package/src/client/components/workspace/editor/SaveAsModal.tsx +175 -0
  110. package/src/client/components/workspace/editor/SplitColumn.tsx +98 -0
  111. package/src/client/components/workspace/editor/SplitPane.tsx +57 -0
  112. package/src/client/components/workspace/editor/StatusBar.tsx +106 -0
  113. package/src/client/components/workspace/editor/TabContextMenu.tsx +75 -0
  114. package/src/client/components/workspace/editor/Tabs.tsx +195 -18
  115. package/src/client/components/workspace/editor/Toolbar.tsx +110 -140
  116. package/src/client/components/workspace/editor/index.tsx +201 -193
  117. package/src/client/components/workspace/editor/props.ts +64 -0
  118. package/src/client/components/workspace/editor/toolbar-clusters.tsx +300 -0
  119. package/src/client/components/workspace/file-explorer/Modals.tsx +14 -1
  120. package/src/client/components/workspace/file-explorer/OutlineSection.test.tsx +18 -0
  121. package/src/client/components/workspace/file-explorer/OutlineSection.tsx +10 -3
  122. package/src/client/components/workspace/file-explorer/TreeItem.tsx +2 -1
  123. package/src/client/components/workspace/file-explorer/clipboard.test.ts +3 -1
  124. package/src/client/components/workspace/file-explorer/index.test.ts +61 -0
  125. package/src/client/components/workspace/file-explorer/index.tsx +10 -48
  126. package/src/client/components/workspace/file-explorer/local-edit.test.ts +8 -3
  127. package/src/client/components/workspace/search-panel/Body.tsx +7 -2
  128. package/src/client/components/workspace/worktree-modal/index.test.tsx +118 -0
  129. package/src/client/hooks/chat/composer/file-drop.ts +22 -37
  130. package/src/client/hooks/chat/composer/pipeline.test.ts +76 -0
  131. package/src/client/hooks/chat/composer/pipeline.ts +12 -1
  132. package/src/client/hooks/chat/omp/reconnect.test.ts +338 -0
  133. package/src/client/hooks/chat/omp/reconnect.ts +187 -0
  134. package/src/client/hooks/chat/omp/run-liveness.test.ts +71 -0
  135. package/src/client/hooks/chat/omp/run-liveness.ts +65 -0
  136. package/src/client/hooks/chat/omp/session-list.activity.test.ts +114 -0
  137. package/src/client/hooks/chat/omp/session-list.test-util.ts +164 -0
  138. package/src/client/hooks/chat/omp/session-list.test.ts +30 -150
  139. package/src/client/hooks/chat/omp/session-list.tsx +69 -9
  140. package/src/client/hooks/chat/timeline/generating.ts +19 -2
  141. package/src/client/hooks/chat/timeline/index.ts +19 -24
  142. package/src/client/hooks/chat/timeline/lost-run.test.ts +329 -0
  143. package/src/client/hooks/chat/timeline/lost-run.ts +177 -0
  144. package/src/client/hooks/chat/timeline/session-load.test-util.ts +205 -0
  145. package/src/client/hooks/chat/timeline/session-load.test.ts +61 -162
  146. package/src/client/hooks/chat/timeline/session-load.ts +69 -37
  147. package/src/client/hooks/chat/timeline/session-switch.test.ts +65 -0
  148. package/src/client/hooks/chat/timeline/session-switch.ts +63 -0
  149. package/src/client/hooks/code/deferred-highlight.test.ts +182 -0
  150. package/src/client/hooks/code/deferred-highlight.ts +129 -0
  151. package/src/client/hooks/editor/caret-position.test.ts +58 -0
  152. package/src/client/hooks/editor/caret-position.ts +48 -0
  153. package/src/client/hooks/editor/file-editor-types.ts +200 -0
  154. package/src/client/hooks/editor/find-history.test.ts +132 -0
  155. package/src/client/hooks/editor/find-history.ts +46 -0
  156. package/src/client/hooks/editor/find-selection-range.test.ts +100 -0
  157. package/src/client/hooks/editor/find-selection-range.ts +49 -0
  158. package/src/client/hooks/editor/find-state.ts +14 -1
  159. package/src/client/hooks/editor/font.test.ts +0 -93
  160. package/src/client/hooks/editor/indent-settings.test.ts +104 -0
  161. package/src/client/hooks/editor/indent-settings.ts +88 -0
  162. package/src/client/hooks/editor/quick-open.test.ts +141 -0
  163. package/src/client/hooks/editor/quick-open.ts +127 -0
  164. package/src/client/hooks/editor/save-as.test.ts +156 -0
  165. package/src/client/hooks/editor/save-as.ts +122 -0
  166. package/src/client/hooks/editor/save-file.test.ts +179 -0
  167. package/src/client/hooks/editor/save-file.ts +73 -28
  168. package/src/client/hooks/editor/theme.test.ts +206 -0
  169. package/src/client/hooks/editor/theme.ts +82 -0
  170. package/src/client/hooks/editor/typing-settings.test.ts +73 -0
  171. package/src/client/hooks/editor/typing-settings.ts +65 -0
  172. package/src/client/hooks/editor/use-close-guard.ts +98 -0
  173. package/src/client/hooks/editor/use-editor-drop-overlay.test.ts +159 -0
  174. package/src/client/hooks/editor/use-editor-drop.shell.test.ts +224 -0
  175. package/src/client/hooks/editor/use-editor-drop.test.ts +101 -0
  176. package/src/client/hooks/editor/use-editor-drop.ts +120 -77
  177. package/src/client/hooks/editor/use-editor-find.test.ts +2 -2
  178. package/src/client/hooks/editor/use-editor-find.ts +45 -10
  179. package/src/client/hooks/editor/use-editor-panel-keys.ts +152 -0
  180. package/src/client/hooks/editor/use-editor-tab-state.ts +71 -0
  181. package/src/client/hooks/editor/use-external-change-notice.ts +71 -0
  182. package/src/client/hooks/editor/use-external-change.test.ts +88 -0
  183. package/src/client/hooks/editor/use-external-change.ts +146 -0
  184. package/src/client/hooks/editor/use-file-editor.ts +83 -116
  185. package/src/client/hooks/editor/use-file-read.ts +16 -8
  186. package/src/client/hooks/editor/use-file-writes.ts +28 -3
  187. package/src/client/hooks/editor/use-mobile-editor-find.ts +69 -0
  188. package/src/client/hooks/editor/use-mobile-reveal.ts +53 -0
  189. package/src/client/hooks/editor/use-outline-view.test.ts +182 -0
  190. package/src/client/hooks/editor/use-outline-view.ts +94 -7
  191. package/src/client/hooks/editor/use-scroll-restore.test.ts +55 -2
  192. package/src/client/hooks/editor/use-scroll-restore.ts +124 -4
  193. package/src/client/hooks/editor/use-search-reveal-jump.ts +57 -0
  194. package/src/client/hooks/editor/use-search-reveal.ts +1 -1
  195. package/src/client/hooks/editor/use-split-editor.test.tsx +169 -0
  196. package/src/client/hooks/editor/use-split-editor.ts +91 -0
  197. package/src/client/hooks/editor/use-unload-guard.tsx +117 -0
  198. package/src/client/hooks/editor/use-write-conflict.test.ts +164 -0
  199. package/src/client/hooks/editor/use-write-conflict.ts +152 -0
  200. package/src/client/hooks/editor/wheel-zoom.test.ts +141 -0
  201. package/src/client/hooks/editor/wheel-zoom.ts +96 -0
  202. package/src/client/hooks/ui/drag-presence.test.ts +193 -0
  203. package/src/client/hooks/ui/drag-presence.ts +108 -0
  204. package/src/client/hooks/ui/settings-modal.test.ts +115 -0
  205. package/src/client/hooks/ui/settings-modal.ts +56 -0
  206. package/src/client/hooks/ui/updates/shell-download.test.ts +2 -0
  207. package/src/client/hooks/ui/updates/shell-download.ts +55 -14
  208. package/src/client/hooks/ui/updates/shell-offer.test.ts +26 -0
  209. package/src/client/hooks/ui/updates/shell-update.test.ts +140 -0
  210. package/src/client/hooks/ui/updates/shell-update.ts +119 -0
  211. package/src/client/hooks/workspace/diff-file.ts +29 -10
  212. package/src/client/hooks/workspace/diff-git-actions.ts +147 -0
  213. package/src/client/hooks/workspace/editor-view.ts +61 -0
  214. package/src/client/hooks/workspace/file-listing.ts +36 -24
  215. package/src/client/hooks/workspace/file-tabs.test.ts +152 -5
  216. package/src/client/hooks/workspace/file-tabs.ts +70 -11
  217. package/src/client/hooks/workspace/file-tree-edits.ts +103 -0
  218. package/src/client/hooks/workspace/navbar-session-actions.ts +72 -0
  219. package/src/client/hooks/workspace/worktree/index.ts +20 -5
  220. package/src/client/lib/desktop/bridge.ts +45 -0
  221. package/src/client/lib/desktop/dropped-paths.ts +83 -0
  222. package/src/client/lib/editor/tab-menu.test.ts +127 -0
  223. package/src/client/lib/editor/tab-menu.ts +127 -0
  224. package/src/client/lib/editor-dirty-tabs.test.ts +102 -0
  225. package/src/client/lib/editor-dirty-tabs.ts +103 -0
  226. package/src/client/lib/native/resume.test.ts +66 -0
  227. package/src/client/lib/native/resume.ts +42 -0
  228. package/src/client/lib/search-reveal.ts +1 -1
  229. package/src/client/main.tsx +13 -1
  230. package/src/client/tailwind.css +75 -8
  231. package/src/server/lib/auth/guard.test.ts +28 -0
  232. package/src/server/lib/auth/guard.ts +10 -0
  233. package/src/server/lib/bundler/css.test.ts +31 -0
  234. package/src/server/lib/fs/listing.test.ts +81 -16
  235. package/src/server/lib/fs/listing.ts +72 -5
  236. package/src/server/lib/fs/worktree/create.ts +2 -3
  237. package/src/server/lib/fs/worktree/list.ts +13 -0
  238. package/src/server/lib/fs/worktree/remove.ts +3 -3
  239. package/src/server/lib/fs/write-conflict.test.ts +68 -0
  240. package/src/server/lib/fs/write-conflict.ts +84 -0
  241. package/src/server/lib/lifecycle/claim-port.test.ts +156 -0
  242. package/src/server/lib/lifecycle/port-guard.test.ts +20 -164
  243. package/src/server/lib/lifecycle/port-guard.ts +39 -7
  244. package/src/server/lib/lifecycle/probe-health.test.ts +166 -0
  245. package/src/server/lib/lifecycle/probe.test.ts +77 -164
  246. package/src/server/lib/lifecycle/probe.ts +121 -13
  247. package/src/server/lib/omp/rpc/frame-fold-signals.test.ts +112 -0
  248. package/src/server/lib/omp/rpc/frame-fold.ts +10 -5
  249. package/src/server/lib/omp/session/sidebar-activity.server.test.ts +162 -0
  250. package/src/server/lib/omp/session/sidebar-activity.server.ts +70 -0
  251. package/src/server/lib/omp/session/telemetry/compute.ts +13 -1
  252. package/src/server/lib/omp/session/telemetry.test.ts +33 -0
  253. package/src/server/lib/realtime/signals.server.ts +10 -0
  254. package/src/server/lib/realtime/topics/catalog.server.ts +4 -1
  255. package/src/server/lib/realtime/topics.server.ts +16 -0
  256. package/src/server/lib/updates/shell-assets.ts +94 -3
  257. package/src/server/lib/updates/shell-cache.ts +105 -0
  258. package/src/server/lib/updates/shell-pages.test.ts +33 -2
  259. package/src/server/lib/updates/shell-pages.ts +17 -5
  260. package/src/server/lib/updates/shell-release-desktop.test.ts +166 -0
  261. package/src/server/lib/updates/shell-release.test.ts +10 -27
  262. package/src/server/lib/updates/shell-release.ts +107 -111
  263. package/src/server/routes/fs/action-save-as.test.ts +82 -0
  264. package/src/server/routes/fs/action.test.ts +82 -0
  265. package/src/server/routes/fs/action.ts +54 -1
  266. package/src/server/routes/fs/exists.ts +11 -1
  267. package/src/server/routes/fs/git-merge.test.ts +11 -1
  268. package/src/server/routes/fs/read.test.ts +24 -7
  269. package/src/server/routes/fs/read.ts +6 -1
  270. package/src/server/routes/fs/scope.test.ts +15 -10
  271. package/src/server/routes/fs/scope.ts +3 -14
  272. package/src/server/routes/updates/android.ts +6 -1
  273. package/src/server/routes/updates/desktop.ts +29 -7
  274. package/src/server/routes/updates/ios.ts +5 -1
  275. package/src/server/routes/worktrees/list.ts +11 -1
  276. package/src/server/routes/worktrees/routes.test.ts +17 -0
  277. package/src/shared/lib/chat/timeline/omp-callbacks.test.ts +36 -0
  278. package/src/shared/lib/chat/timeline/omp-callbacks.ts +18 -0
  279. package/src/shared/lib/chat/timeline/run-signals.test.ts +2 -0
  280. package/src/shared/lib/code/editor/comment-syntax.test.ts +37 -0
  281. package/src/shared/lib/code/editor/comment-syntax.ts +55 -0
  282. package/src/shared/lib/code/editor/find-replace.test.ts +134 -0
  283. package/src/shared/lib/code/editor/{find.ts → find-replace.ts} +23 -107
  284. package/src/shared/lib/code/editor/{find.test.ts → find-scan.test.ts} +20 -74
  285. package/src/shared/lib/code/editor/find-scan.ts +198 -0
  286. package/src/shared/lib/code/editor/find-selection.test.ts +56 -0
  287. package/src/shared/lib/code/editor/indent-guide-rule.test.ts +65 -0
  288. package/src/shared/lib/code/editor/indent-guide-rule.ts +47 -0
  289. package/src/shared/lib/code/editor/indent-rules.test.ts +219 -0
  290. package/src/shared/lib/code/editor/indent-rules.ts +198 -0
  291. package/src/shared/lib/code/editor/keymap.test.ts +23 -0
  292. package/src/shared/lib/code/editor/keymap.ts +43 -6
  293. package/src/shared/lib/code/editor/lines.test.ts +7 -55
  294. package/src/shared/lib/code/editor/lines.ts +8 -48
  295. package/src/shared/lib/code/editor/marks.test.ts +4 -5
  296. package/src/shared/lib/code/editor/marks.ts +13 -25
  297. package/src/shared/lib/code/editor/palette.test.ts +25 -2
  298. package/src/shared/lib/code/editor/palette.ts +10 -0
  299. package/src/shared/lib/code/editor/stream-modes.ts +225 -0
  300. package/src/shared/lib/code/editor/theme-loader.ts +97 -0
  301. package/src/shared/lib/code/editor/themes.generated.ts +156 -0
  302. package/src/shared/lib/code/editor/themes.test.ts +165 -0
  303. package/src/shared/lib/code/editor/themes.ts +165 -0
  304. package/src/shared/lib/code/highlight-memo.test.ts +103 -0
  305. package/src/shared/lib/code/highlight-memo.ts +149 -0
  306. package/src/shared/lib/code/highlighter-warmup.ts +112 -0
  307. package/src/shared/lib/code/highlighter.ts +3 -1
  308. package/src/shared/lib/code/idle.ts +37 -0
  309. package/src/shared/lib/code/outline/rows.test.ts +96 -0
  310. package/src/shared/lib/code/outline/rows.ts +94 -0
  311. package/src/shared/lib/code/syntax-highlight.test.ts +2 -80
  312. package/src/shared/lib/code/syntax-highlight.ts +2 -3
  313. package/src/shared/lib/fs/file-kind-classify.test.ts +25 -11
  314. package/src/shared/lib/fs/file-kind.ts +47 -13
  315. package/src/shared/lib/fs/file-tree.test.ts +41 -0
  316. package/src/shared/lib/fs/file-tree.ts +126 -34
  317. package/src/shared/lib/fs/file-url.test.ts +52 -0
  318. package/src/shared/lib/fs/file-url.ts +37 -0
  319. package/src/shared/lib/fs/folder-chain.test.ts +87 -0
  320. package/src/shared/lib/fs/folder-chain.ts +91 -0
  321. package/src/shared/lib/fs/fs-helpers.test.ts +4 -50
  322. package/src/shared/lib/fs/patch-sides.test.ts +114 -0
  323. package/src/shared/lib/fs/patch-sides.ts +139 -0
  324. package/src/shared/lib/realtime/connection.test.ts +5 -1
  325. package/src/shared/lib/realtime/connection.ts +25 -119
  326. package/src/shared/lib/realtime/frozen-recovery.test.ts +93 -0
  327. package/src/shared/lib/realtime/protocol.ts +16 -0
  328. package/src/shared/lib/realtime/resume.ts +223 -0
  329. package/src/shared/lib/realtime/state.ts +22 -0
  330. package/src/shared/lib/realtime/watchdog-wiring.test.ts +224 -0
  331. package/src/shared/lib/realtime/watchdog.test.ts +99 -0
  332. package/src/shared/lib/realtime/watchdog.ts +72 -0
  333. package/src/shared/lib/ui/toolbar-overflow.test.ts +83 -0
  334. package/src/shared/lib/ui/toolbar-overflow.ts +86 -0
  335. package/src/shared/lib/updates/shell-arch.ts +54 -0
  336. package/src/shared/lib/updates/shell-ua.ts +4 -4
  337. package/src/shared/lib/workspace/editor-view-mode.test.ts +70 -0
  338. package/src/shared/lib/workspace/editor-view-mode.ts +48 -0
  339. package/src/shared/lib/workspace/panel-widths.test.ts +30 -0
  340. package/src/shared/lib/workspace/panel-widths.ts +25 -5
  341. package/src/shared/lib/workspace/session-state/cache.ts +159 -0
  342. package/src/shared/lib/workspace/session-state/harness.test-util.ts +55 -0
  343. package/src/shared/lib/workspace/session-state/merge.ts +100 -0
  344. package/src/shared/lib/workspace/session-state/store-load.test.ts +206 -0
  345. package/src/shared/lib/workspace/session-state/store.test.ts +17 -139
  346. package/src/shared/lib/workspace/session-state/store.ts +92 -130
  347. package/src/shared/lib/workspace/split-editor.test.ts +104 -0
  348. package/src/shared/lib/workspace/split-editor.ts +129 -0
  349. package/src/shared/lib/workspace/workspace-panel-widths.ts +124 -0
  350. package/src/shared/types/realtime.ts +29 -0
  351. package/src/shared/types/settings/state.ts +10 -0
  352. package/src/test-support/file-explorer-disk.test-util.ts +30 -3
  353. package/src/test-support/loopback.ts +183 -0
  354. package/src/test-support/pristine-globals.ts +7 -0
  355. package/dist/client/static/js/index-gtbpewr7.css +0 -1
  356. package/src/client/components/common/code-editor/handler.test.ts +0 -274
  357. package/src/client/components/common/code-editor/handler.ts +0 -175
  358. package/src/client/components/common/code-editor/index.tsx +0 -314
  359. package/src/client/components/common/code-surface/measure.ts +0 -148
  360. package/src/client/components/workspace/chat-timeline/target-picker/index.test.tsx +0 -227
  361. package/src/client/components/workspace/chat-timeline/target-picker/index.tsx +0 -260
  362. package/src/client/components/workspace/diff-panel/SplitView.tsx +0 -209
  363. package/src/client/components/workspace/diff-panel/UnifiedView.tsx +0 -150
  364. package/src/client/hooks/editor/scroll-container.test.ts +0 -102
  365. package/src/client/hooks/editor/scroll-container.ts +0 -26
  366. package/src/client/hooks/editor/use-code-window.ts +0 -100
  367. package/src/client/hooks/editor/use-editor-history.test.ts +0 -216
  368. package/src/client/hooks/editor/use-editor-history.ts +0 -134
  369. package/src/client/hooks/editor/use-occurrences.test.ts +0 -236
  370. package/src/client/hooks/editor/use-occurrences.ts +0 -98
  371. package/src/shared/lib/code/editor/commands.test.ts +0 -155
  372. package/src/shared/lib/code/editor/commands.ts +0 -260
  373. package/src/shared/lib/code/editor/edits.test.ts +0 -100
  374. package/src/shared/lib/code/editor/edits.ts +0 -122
  375. package/src/shared/lib/code/editor/history.test.ts +0 -118
  376. package/src/shared/lib/code/editor/history.ts +0 -101
  377. package/src/shared/lib/code/editor/layers.test.ts +0 -77
  378. package/src/shared/lib/code/editor/layers.ts +0 -67
  379. package/src/shared/lib/code/editor/line-edits.test.ts +0 -131
  380. package/src/shared/lib/code/editor/line-edits.ts +0 -159
  381. package/src/shared/lib/code/editor/occurrences.test.ts +0 -117
  382. package/src/shared/lib/code/editor/occurrences.ts +0 -111
  383. package/src/shared/lib/code/editor/reset-css.test.ts +0 -35
  384. package/src/shared/lib/code/editor/reset-css.ts +0 -32
  385. package/src/shared/lib/code/editor/text-commands.test.ts +0 -178
  386. package/src/shared/lib/code/editor/text-commands.ts +0 -154
  387. package/src/shared/lib/code/lazy-window.test.ts +0 -161
  388. package/src/shared/lib/code/lazy-window.ts +0 -156
  389. package/src/shared/lib/code/windowed-highlight.ts +0 -114
  390. package/src/shared/lib/fs/diff-parser.test.ts +0 -116
  391. package/src/shared/lib/fs/diff-parser.ts +0 -213
@@ -0,0 +1,215 @@
1
+ /**
2
+ * @license
3
+ * SPDX-License-Identifier: Apache-2.0
4
+ */
5
+
6
+ /**
7
+ * The toolbar stays ONE row, and what does not fit is one click away.
8
+ *
9
+ * The failure this pins is a row that becomes two: the editor panel is 320px
10
+ * wide on a 1440px screen, and the width-mode buttons pushed ten controls past
11
+ * it. Wrapping moved the document down by the toolbar's own height and read as
12
+ * a second toolbar; a horizontal scroll clipped the tail invisibly. Neither is
13
+ * visible to a state-only assertion, so the cases below are about what is
14
+ * RENDERED and what the `⋯` menu offers.
15
+ *
16
+ * happy-dom lays nothing out, so `getBoundingClientRect` and `clientWidth` are
17
+ * stubbed at the PROTOTYPE level — the rule reads exactly those two values, and
18
+ * stubbing them before the first render is what lets the component's own layout
19
+ * effect measure a real row instead of a row of zeros.
20
+ */
21
+
22
+ import { afterAll, afterEach, beforeAll, describe, expect, test } from 'bun:test';
23
+ import { Window } from 'happy-dom';
24
+ import { h, render } from 'preact';
25
+ import { act } from 'preact/test-utils';
26
+ import { Save, Search, WrapText } from 'lucide-preact';
27
+ import { ToolbarRow, type ToolbarCluster } from '@/client/components/common/toolbar-row';
28
+ import { installDomGlobals, restoreDomGlobals } from '@/test-support/pristine-globals';
29
+
30
+ let container: HTMLElement;
31
+ /** What the stubbed layout reports for the row, and for each cluster in order. */
32
+ let rowWidth = 0;
33
+ let clusterWidths: number[] = [];
34
+
35
+ /** Captured inside `beforeAll`: the DOM globals do not exist at module load. */
36
+ let originalRect: typeof Element.prototype.getBoundingClientRect;
37
+ let originalClientWidth: PropertyDescriptor | undefined;
38
+
39
+ /** The row is the flex container the component renders; clusters carry a marker. */
40
+ function isRow(el: HTMLElement): boolean {
41
+ return el.className.includes('flex-nowrap');
42
+ }
43
+
44
+ function rectOf(width: number): DOMRect {
45
+ return { width, height: 0, top: 0, left: 0, right: width, bottom: 0, x: 0, y: 0, toJSON: () => ({}) } as DOMRect;
46
+ }
47
+
48
+ beforeAll(() => {
49
+ installDomGlobals(new Window({ url: 'http://localhost' }));
50
+ originalRect = Element.prototype.getBoundingClientRect;
51
+ originalClientWidth = Object.getOwnPropertyDescriptor(HTMLElement.prototype, 'clientWidth');
52
+ Element.prototype.getBoundingClientRect = function (this: Element) {
53
+ const el = this as HTMLElement;
54
+ if (el.hasAttribute?.('data-toolbar-cluster')) {
55
+ const siblings = [...(el.parentElement?.querySelectorAll('[data-toolbar-cluster]') ?? [])];
56
+ return rectOf(clusterWidths[siblings.indexOf(el)] ?? 0);
57
+ }
58
+ if (isRow(el)) return rectOf(rowWidth);
59
+ return originalRect.call(this);
60
+ };
61
+ Object.defineProperty(HTMLElement.prototype, 'clientWidth', {
62
+ configurable: true,
63
+ get(this: HTMLElement) {
64
+ if (isRow(this)) return rowWidth;
65
+ return originalClientWidth?.get?.call(this) ?? 0;
66
+ },
67
+ });
68
+ });
69
+
70
+ afterEach(() => {
71
+ if (container) {
72
+ render(null, container);
73
+ container.remove();
74
+ }
75
+ rowWidth = 0;
76
+ clusterWidths = [];
77
+ });
78
+
79
+ afterAll(() => {
80
+ Element.prototype.getBoundingClientRect = originalRect;
81
+ if (originalClientWidth) Object.defineProperty(HTMLElement.prototype, 'clientWidth', originalClientWidth);
82
+ restoreDomGlobals();
83
+ });
84
+
85
+ /** Three clusters, the first pinned — the editor toolbar in miniature. */
86
+ function clusters(onSelect: string[] = []): ToolbarCluster[] {
87
+ const make = (id: string, label: string, icon: typeof Save, pinned?: boolean): ToolbarCluster => ({
88
+ id,
89
+ pinned,
90
+ actions: [{ label, icon, onSelect: () => onSelect.push(label) }],
91
+ children: h('button', { type: 'button', 'aria-label': label }, label),
92
+ });
93
+ return [
94
+ make('save', 'Save file', Save, true),
95
+ make('find', 'Find and replace', Search),
96
+ make('wrap', 'Word wrap on', WrapText),
97
+ ];
98
+ }
99
+
100
+ async function mount(width: number, widths: number[], onSelect: string[] = []): Promise<void> {
101
+ rowWidth = width;
102
+ clusterWidths = widths;
103
+ container = document.createElement('div');
104
+ document.body.appendChild(container);
105
+ await act(async () => {
106
+ render(h(ToolbarRow, { clusters: clusters(onSelect) }), container);
107
+ });
108
+ // The layout effect commits its measurement in a second pass, the way the
109
+ // browser gives one before paint.
110
+ await act(async () => {});
111
+ }
112
+
113
+ function rowButtons(): HTMLButtonElement[] {
114
+ const host = container.firstElementChild as HTMLElement;
115
+ return [...host.querySelectorAll<HTMLButtonElement>(':scope > div > button')];
116
+ }
117
+
118
+ async function openMenu(): Promise<void> {
119
+ const trigger = rowButtons().find((button) => button.getAttribute('aria-label') === 'More actions');
120
+ if (!trigger) throw new Error('no overflow trigger rendered');
121
+ await act(async () => {
122
+ trigger.dispatchEvent(new window.MouseEvent('click', { bubbles: true }) as never);
123
+ });
124
+ }
125
+
126
+ /**
127
+ * The menu lives in `document.body`, NOT inside the row.
128
+ *
129
+ * It is portalled out because the row is `overflow-hidden` and one line tall:
130
+ * an inline `absolute top-full` menu is clipped to nothing, so every row was
131
+ * invisible and unclickable while the trigger said `aria-expanded="true"`
132
+ * (measured: the menu laid out 208×206px and `elementFromPoint` at its centre
133
+ * answered a `.cm-line` in the diff behind it). Querying the menu inside the
134
+ * container would therefore find nothing — which is the bug, not the fixture.
135
+ */
136
+ function menuItems(): HTMLElement[] {
137
+ return [...document.querySelectorAll<HTMLElement>('[role="menuitem"]')];
138
+ }
139
+
140
+ describe('ToolbarRow overflow', () => {
141
+ test('a wide row draws every cluster and no trigger', async () => {
142
+ await mount(400, [60, 60, 60]);
143
+ expect(rowButtons().map((button) => button.getAttribute('aria-label'))).toEqual([
144
+ 'Save file',
145
+ 'Find and replace',
146
+ 'Word wrap on',
147
+ ]);
148
+ });
149
+
150
+ test('a narrow row keeps the pinned cluster and moves the rest into `⋯`', async () => {
151
+ await mount(120, [60, 60, 60]);
152
+ const labels = rowButtons().map((button) => button.getAttribute('aria-label'));
153
+ expect(labels).toContain('Save file');
154
+ expect(labels).toContain('More actions');
155
+ expect(labels).not.toContain('Word wrap on');
156
+ });
157
+
158
+ test('the menu offers the hidden controls, named in words', async () => {
159
+ await mount(120, [60, 60, 60]);
160
+ await openMenu();
161
+ const items = menuItems().map((item) => item.textContent?.trim());
162
+ expect(items).toContain('Word wrap on');
163
+ // The pinned control is on the row, so it is NOT in the menu.
164
+ expect(items).not.toContain('Save file');
165
+ });
166
+
167
+ test('the menu is portalled out of the clipping row', async () => {
168
+ await mount(120, [60, 60, 60]);
169
+ await openMenu();
170
+ const menu = document.querySelector('[role="menu"]');
171
+ if (!menu) throw new Error('no menu rendered');
172
+ // The row clips; the menu must not be its descendant.
173
+ expect((container.firstElementChild as HTMLElement).contains(menu)).toBe(false);
174
+ expect(menu.parentElement).toBe(document.body);
175
+ });
176
+
177
+ test('a menu row runs the same action the button would', async () => {
178
+ const ran: string[] = [];
179
+ await mount(120, [60, 60, 60], ran);
180
+ await openMenu();
181
+ const item = menuItems().find((row) => row.textContent?.trim() === 'Word wrap on');
182
+ if (!item) throw new Error('the wrap row is missing from the menu');
183
+ await act(async () => {
184
+ item.dispatchEvent(new window.MouseEvent('click', { bubbles: true }) as never);
185
+ });
186
+ expect(ran).toEqual(['Word wrap on']);
187
+ });
188
+
189
+ /**
190
+ * A press on a menu row must not be read as "outside".
191
+ *
192
+ * `useOnClickOutside` watches ONE ref, and the menu is no longer inside the
193
+ * trigger's subtree — so a mousedown on a row closed the menu and the `click`
194
+ * never reached the button. That is the same dead menu in a new shape.
195
+ */
196
+ test('pressing inside the menu keeps it open', async () => {
197
+ const ran: string[] = [];
198
+ await mount(120, [60, 60, 60], ran);
199
+ await openMenu();
200
+ const item = menuItems().find((row) => row.textContent?.trim() === 'Word wrap on');
201
+ if (!item) throw new Error('the wrap row is missing from the menu');
202
+
203
+ await act(async () => {
204
+ item.dispatchEvent(new window.MouseEvent('mousedown', { bubbles: true }) as never);
205
+ });
206
+ // Still open, so the following click can land.
207
+ expect(document.querySelector('[role="menu"]')).not.toBeNull();
208
+
209
+ await act(async () => {
210
+ item.dispatchEvent(new window.MouseEvent('click', { bubbles: true }) as never);
211
+ });
212
+ expect(ran).toEqual(['Word wrap on']);
213
+ expect(document.querySelector('[role="menu"]')).toBeNull();
214
+ });
215
+ });
@@ -0,0 +1,260 @@
1
+ /**
2
+ * @license
3
+ * SPDX-License-Identifier: Apache-2.0
4
+ */
5
+
6
+ /**
7
+ * One toolbar row that never becomes two.
8
+ *
9
+ * The editor and diff toolbars carry ten-plus controls and the editor panel is
10
+ * 320px wide on a 1440px screen. WRAPPING was the previous answer and it is the
11
+ * wrong one: a second row moves the document down by the toolbar's own height
12
+ * and reads as a second toolbar. A horizontal scroll is worse — a clipped
13
+ * control is invisible. So the clusters that do not fit move into a `⋯` menu and
14
+ * every control stays one click away.
15
+ *
16
+ * Widths are MEASURED, never tabulated: the row lays every cluster out once and
17
+ * reads each one's rendered width, then hides what does not fit. A table of
18
+ * guessed pixel widths drifts the moment a label, an icon or a font changes, and
19
+ * a wrong guess here is a control that is either clipped or needlessly buried.
20
+ */
21
+
22
+ import { useEffect, useLayoutEffect, useRef, useState } from 'preact/hooks';
23
+ import type { ComponentChildren } from 'preact';
24
+ import { createPortal } from 'preact/compat';
25
+ import { Ellipsis, type LucideIcon } from 'lucide-preact';
26
+ import { toolbarHasOverflow, toolbarVisibleClusters } from '@/shared/lib/ui/toolbar-overflow';
27
+
28
+ /** One row the `⋯` menu offers when its cluster is not on the row. */
29
+ export interface ToolbarOverflowAction {
30
+ label: string;
31
+ icon: LucideIcon;
32
+ onSelect: () => void;
33
+ /** Rendered as a pressed row (word wrap on, a mode already active). */
34
+ active?: boolean;
35
+ disabled?: boolean;
36
+ }
37
+
38
+ /**
39
+ * A logical group of controls that hides as a unit.
40
+ *
41
+ * A group rather than a single button because the clusters are already grouped
42
+ * in the toolbars (zoom is two buttons, copy/download is a pair, the width modes
43
+ * are a pair) and splitting them would let half of a pair stay on the row.
44
+ */
45
+ export interface ToolbarCluster {
46
+ id: string;
47
+ /**
48
+ * Never leave the row, whatever its width.
49
+ *
50
+ * The visual order is not the priority order: Save is drawn first because that
51
+ * is where a reader looks for it, while the width modes sit last and are the
52
+ * reason the panel exists. Pinning says which ones a menu row must not be the
53
+ * only way to reach.
54
+ */
55
+ pinned?: boolean;
56
+ /** What the `⋯` menu offers when this cluster is hidden. */
57
+ actions: ToolbarOverflowAction[];
58
+ children: ComponentChildren;
59
+ }
60
+
61
+ interface ToolbarRowProps {
62
+ clusters: ToolbarCluster[];
63
+ className?: string;
64
+ }
65
+
66
+ export function ToolbarRow({ clusters, className = '' }: ToolbarRowProps) {
67
+ const rowRef = useRef<HTMLDivElement>(null);
68
+ /** Measured widths, tagged with the cluster set they describe. */
69
+ const [metrics, setMetrics] = useState<{ signature: string; widths: number[] } | null>(null);
70
+ const [available, setAvailable] = useState(0);
71
+
72
+ // The set changes when a conditional cluster appears or disappears (a
73
+ // previewable file opened, a byte viewer took over), and stale widths would
74
+ // then hide the wrong cluster. Rendering every cluster until they are measured
75
+ // is what gives the ruler something to measure — and the layout effect runs
76
+ // BEFORE paint, so the unresolved frame is never seen.
77
+ const signature = clusters.map((cluster) => `${cluster.id}:${cluster.pinned ? 1 : 0}`).join('|');
78
+ const ready = metrics?.signature === signature;
79
+ const widths = ready ? metrics.widths : [];
80
+ const pinned = clusters.map((cluster) => cluster.pinned === true);
81
+ const visible = widths.length > 0
82
+ ? toolbarVisibleClusters({ widths, pinned, available })
83
+ : clusters.map(() => true);
84
+
85
+ useLayoutEffect(() => {
86
+ const row = rowRef.current;
87
+ if (!row) return;
88
+ if (!ready) {
89
+ const children = [...row.querySelectorAll<HTMLElement>('[data-toolbar-cluster]')];
90
+ if (children.length === clusters.length) {
91
+ setMetrics({ signature, widths: children.map((child) => child.getBoundingClientRect().width) });
92
+ }
93
+ }
94
+ setAvailable(row.clientWidth);
95
+ });
96
+
97
+ // The row's width changes on a window resize, a panel drag and a layout mode
98
+ // switch — none of which are `window` events.
99
+ useEffect(() => {
100
+ const row = rowRef.current;
101
+ if (!row || typeof ResizeObserver === 'undefined') return;
102
+ const observer = new ResizeObserver(() => setAvailable(row.clientWidth));
103
+ observer.observe(row);
104
+ return () => observer.disconnect();
105
+ }, []);
106
+
107
+ const hiddenActions = clusters.filter((_, index) => !visible[index]).flatMap((cluster) => cluster.actions);
108
+
109
+ // `flex-1 min-w-0` is what makes `available` mean anything. Without it the row
110
+ // is content-sized (`ml-auto` in a `justify-between` parent), so its width IS
111
+ // the sum of the clusters it currently shows — hiding one shrinks the row,
112
+ // which shrinks `available`, which hides another, and the row settles at a
113
+ // fraction of the space it was given and never grows back when the panel is
114
+ // widened. Measured: a 373px diff panel reported a 204px row at every
115
+ // viewport, so Unified/Split/Full Code lived in `⋯` on a wide screen. `min-w-0`
116
+ // is required with it, or the `flex-shrink-0` clusters set a content-based
117
+ // minimum and the row refuses to be narrower than all of them.
118
+ return (
119
+ <div ref={rowRef} className={`flex flex-1 min-w-0 flex-nowrap items-center justify-end gap-x-1 overflow-hidden ${className}`}>
120
+ {clusters.map((cluster, index) =>
121
+ visible[index] ? (
122
+ <div key={cluster.id} data-toolbar-cluster="" className="flex items-center flex-shrink-0">
123
+ {cluster.children}
124
+ </div>
125
+ ) : null,
126
+ )}
127
+ {toolbarHasOverflow(visible) && <OverflowMenu actions={hiddenActions} />}
128
+ </div>
129
+ );
130
+ }
131
+
132
+ /**
133
+ * The `⋯` trigger and its menu.
134
+ *
135
+ * A menu rather than a horizontal scroll: a clipped action is invisible, and the
136
+ * diff toolbar already learned that a scroll strip with no visible scrollbar
137
+ * reads as "there is nothing more here" (measured: 361px of content in a 296px
138
+ * box, with `Stage` entirely outside it).
139
+ *
140
+ * The menu is PORTALLED to `document.body`, and that is not a preference — the
141
+ * row it hangs from is `overflow-hidden` and only one line tall, so an
142
+ * absolutely-positioned menu below the trigger is clipped to nothing. Measured
143
+ * before the portal: the menu laid out at 208×206px and `elementFromPoint` at
144
+ * its own centre answered a `.cm-line` in the diff BEHIND it, so every row was
145
+ * invisible and unclickable while the trigger reported `aria-expanded="true"`.
146
+ * A `fixed` menu inside the row would not help either: `overflow-hidden` clips
147
+ * a fixed descendant too, because the row establishes the containing block.
148
+ *
149
+ * Position comes from the trigger's own viewport rect, clamped against both
150
+ * edges, so a menu on the right-hand toolbar of a narrow panel cannot draw its
151
+ * rows past the window.
152
+ */
153
+ function OverflowMenu({ actions }: { actions: ToolbarOverflowAction[] }) {
154
+ const [open, setOpen] = useState(false);
155
+ const [position, setPosition] = useState<{ top: number; left: number } | null>(null);
156
+ const rootRef = useRef<HTMLDivElement>(null);
157
+ const menuRef = useRef<HTMLDivElement>(null);
158
+
159
+ // A dismiss handler that knows about BOTH nodes. `useOnClickOutside` takes one
160
+ // ref, and the menu is no longer inside the trigger's subtree — a mousedown on
161
+ // a menu row would read as "outside", close the menu, and the `click` would
162
+ // never reach the button. That is the same dead menu in a new shape.
163
+ useEffect(() => {
164
+ if (!open) return;
165
+ const onPointerDown = (event: globalThis.MouseEvent | globalThis.TouchEvent) => {
166
+ const target = event.target as Node;
167
+ if (rootRef.current?.contains(target) || menuRef.current?.contains(target)) return;
168
+ setOpen(false);
169
+ };
170
+ document.addEventListener('mousedown', onPointerDown);
171
+ document.addEventListener('touchstart', onPointerDown);
172
+ return () => {
173
+ document.removeEventListener('mousedown', onPointerDown);
174
+ document.removeEventListener('touchstart', onPointerDown);
175
+ };
176
+ }, [open]);
177
+
178
+ useEffect(() => {
179
+ if (!open) return;
180
+ const onKeyDown = (event: globalThis.KeyboardEvent) => {
181
+ if (event.key === 'Escape') setOpen(false);
182
+ };
183
+ document.addEventListener('keydown', onKeyDown);
184
+ return () => document.removeEventListener('keydown', onKeyDown);
185
+ }, [open]);
186
+
187
+ // Measured before paint, and re-measured when the row's own size changes: the
188
+ // trigger sits at the row's trailing edge, so a panel drag moves it.
189
+ useLayoutEffect(() => {
190
+ if (!open) return;
191
+ const trigger = rootRef.current?.firstElementChild as HTMLElement | null;
192
+ const menu = menuRef.current;
193
+ if (!trigger || !menu) return;
194
+ const anchor = trigger.getBoundingClientRect();
195
+ const { width, height } = menu.getBoundingClientRect();
196
+ const margin = 8;
197
+ const below = anchor.bottom + 4;
198
+ const top = below + height + margin <= window.innerHeight ? below : Math.max(margin, anchor.top - height - 4);
199
+ const left = Math.max(margin, Math.min(anchor.right - width, window.innerWidth - width - margin));
200
+ setPosition({ top, left });
201
+ }, [open, actions.length]);
202
+
203
+ return (
204
+ <div className="relative flex-shrink-0" ref={rootRef}>
205
+ <button
206
+ type="button"
207
+ title="More actions"
208
+ aria-label="More actions"
209
+ aria-haspopup="menu"
210
+ aria-expanded={open}
211
+ onClick={() => {
212
+ setPosition(null);
213
+ setOpen(!open);
214
+ }}
215
+ className={`flex items-center justify-center p-1.5 rounded transition-colors cursor-pointer ${
216
+ open ? 'bg-ink/10 text-ink' : 'text-ink/50 hover:text-ink hover:bg-ink/5'
217
+ }`}
218
+ >
219
+ <Ellipsis size={14} />
220
+ </button>
221
+
222
+ {open &&
223
+ createPortal(
224
+ <div
225
+ ref={menuRef}
226
+ role="menu"
227
+ style={{
228
+ top: position?.top ?? 0,
229
+ left: position?.left ?? 0,
230
+ // Hidden for the single pre-measure render; the layout effect
231
+ // settles the position before the browser paints.
232
+ visibility: position ? 'visible' : 'hidden',
233
+ }}
234
+ className="fixed z-[80] w-52 bg-paper border border-ink/15 rounded-lg shadow-lg py-1 text-xs"
235
+ >
236
+ {actions.map((action) => (
237
+ <button
238
+ key={action.label}
239
+ type="button"
240
+ role="menuitem"
241
+ disabled={action.disabled}
242
+ aria-pressed={action.active}
243
+ onClick={() => {
244
+ setOpen(false);
245
+ action.onSelect();
246
+ }}
247
+ className={`w-full text-left flex items-center gap-2 px-3 py-1.5 transition-colors disabled:cursor-default disabled:opacity-40 ${
248
+ action.active ? 'bg-ink/5 text-ink font-medium' : 'text-ink/75 hover:bg-ink/5 hover:text-ink'
249
+ }`}
250
+ >
251
+ <action.icon size={13} className="flex-shrink-0" />
252
+ <span className="truncate">{action.label}</span>
253
+ </button>
254
+ ))}
255
+ </div>,
256
+ document.body,
257
+ )}
258
+ </div>
259
+ );
260
+ }