@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
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@kabmo-labs/kabmo",
3
- "version": "0.8.0",
3
+ "version": "0.10.0",
4
4
  "description": "Web console and diagnostic workbench for AI coding agents — Elysia + Preact on Bun.",
5
5
  "license": "UNLICENSED",
6
6
  "author": "Wijanarko Putra Rajeb <wijanarko.rajeb@gmail.com>",
@@ -45,6 +45,8 @@
45
45
  "dev": "bun run --hot src/server/index.ts --kabmo-server",
46
46
  "dev:lan": "HOST=0.0.0.0 bun run --hot src/server/index.ts --kabmo-server",
47
47
  "build": "bun run scripts/build-client.ts",
48
+ "editor:themes": "bun run scripts/editor-themes.mjs",
49
+ "editor:themes:check": "bun run scripts/editor-themes.mjs --check",
48
50
  "omp:schema": "bun run scripts/omp-schema.mjs",
49
51
  "omp:schema:check": "bun run scripts/omp-schema.mjs --check",
50
52
  "start": "NODE_ENV=production bun run src/server/index.ts --kabmo-server",
@@ -59,6 +61,14 @@
59
61
  "publish:plugins": "bash .github/scripts/publish-plugin-packages.sh packages/kabmo-sdk packages/kabmo-ui"
60
62
  },
61
63
  "dependencies": {
64
+ "@codemirror/autocomplete": "6.20.4",
65
+ "@codemirror/commands": "6.11.1",
66
+ "@codemirror/language": "6.13.1",
67
+ "@codemirror/legacy-modes": "^6.5.5",
68
+ "@codemirror/merge": "6.12.3",
69
+ "@codemirror/search": "6.7.2",
70
+ "@codemirror/state": "6.7.6",
71
+ "@codemirror/view": "6.43.15",
62
72
  "@fontsource/fira-code": "^5.3.0",
63
73
  "@kabmo-labs/kabmo-sdk": "0.1.0",
64
74
  "@kabmo-labs/kabmo-ui": "0.0.1",
@@ -0,0 +1,249 @@
1
+ /**
2
+ * @license
3
+ * SPDX-License-Identifier: Apache-2.0
4
+ */
5
+
6
+ /**
7
+ * The bracket pair guide, and the mode table that makes pairing token-aware.
8
+ *
9
+ * Three failure modes are silent here and each is a test:
10
+ *
11
+ * - A guide drawn at the line's LEFT edge instead of under the opening brace
12
+ * looks like an indent guide, which is a different feature. The column is a
13
+ * decoration attribute, so the assertion is on the emitted style.
14
+ * - A guide through a BLANK line makes a block read as if it continued across
15
+ * the gap between two functions.
16
+ * - A mode table entry that does not exist in `@codemirror/legacy-modes` fails
17
+ * only when a user opens that language — so every entry is resolved here.
18
+ */
19
+
20
+ import { describe, expect, test } from 'bun:test';
21
+ import { EditorState } from '@codemirror/state';
22
+ import { Decoration } from '@codemirror/view';
23
+
24
+ import {
25
+ bracketGuideDecorations,
26
+ bracketPairAt,
27
+ MAX_GUIDE_LINES,
28
+ } from '@/client/components/common/code-surface/bracket-guide';
29
+ import {
30
+ STREAM_MODE_EXPORTS,
31
+ STREAM_MODE_LOADERS,
32
+ TEXTUAL_ONLY_LANGS,
33
+ streamModeFor,
34
+ } from '@/shared/lib/code/editor/stream-modes';
35
+ import { LANG_LOADERS } from '@/shared/lib/code/shiki-langs';
36
+
37
+ function stateOf(doc: string, caret: number): EditorState {
38
+ return EditorState.create({ doc, selection: { anchor: caret } });
39
+ }
40
+
41
+ /** The lines a guide decorates, as 1-based numbers. */
42
+ function guidedLines(state: EditorState): number[] {
43
+ const lines: number[] = [];
44
+ const set = bracketGuideDecorations(state);
45
+ const iter = set.iter();
46
+ while (iter.value) {
47
+ lines.push(state.doc.lineAt(iter.from).number);
48
+ iter.next();
49
+ }
50
+ return lines;
51
+ }
52
+
53
+ /** The column each guide carries, from the emitted attribute. */
54
+ function guideColumns(state: EditorState): string[] {
55
+ const columns: string[] = [];
56
+ const iter = bracketGuideDecorations(state).iter();
57
+ while (iter.value) {
58
+ const spec = iter.value.spec as { attributes?: Record<string, string> };
59
+ columns.push(spec.attributes?.style ?? '');
60
+ iter.next();
61
+ }
62
+ return columns;
63
+ }
64
+
65
+ const DOC = [
66
+ 'function outer() {',
67
+ ' if (a) {',
68
+ ' inner();',
69
+ ' }',
70
+ ' return 1;',
71
+ '}',
72
+ ].join('\n');
73
+
74
+ describe('bracketPairAt', () => {
75
+ test('the caret beside an opening brace finds its pair', () => {
76
+ const open = DOC.indexOf('{', DOC.indexOf('if'));
77
+ const state = stateOf(DOC, open + 1);
78
+ const pair = bracketPairAt(state);
79
+ expect(pair).not.toBeNull();
80
+ expect(pair?.open).toBe(open);
81
+ // `close` is the offset just PAST the closing brace: `bracketPairAt` stores
82
+ // `match.end.to` so the guide's span covers the brace glyph itself.
83
+ expect(pair?.close).toBe(DOC.indexOf('}', DOC.indexOf('inner')) + 1);
84
+ expect(DOC[pair!.close - 1]).toBe('}');
85
+ });
86
+
87
+ test('the caret beside the CLOSING brace finds the same pair', () => {
88
+ const close = DOC.indexOf('\n}', DOC.indexOf('return 1')) + 1;
89
+ const state = stateOf(DOC, close);
90
+ expect(bracketPairAt(state)?.open).toBe(DOC.indexOf('{'));
91
+ });
92
+
93
+ test('a caret in ordinary text has no pair', () => {
94
+ expect(bracketPairAt(stateOf(DOC, DOC.indexOf('inner')))).toBeNull();
95
+ });
96
+ });
97
+
98
+ describe('bracketGuideDecorations', () => {
99
+ test('every non-blank line between the braces gets a guide', () => {
100
+ const open = DOC.indexOf('{', DOC.indexOf('if'));
101
+ // Lines 3 (`inner();`) and 4 (`}`) sit between the `if` opener (line 2) and
102
+ // its closing brace (line 4) — line 4 is the closing brace's own line, so
103
+ // only line 3 is strictly between.
104
+ expect(guidedLines(stateOf(DOC, open + 1))).toEqual([3]);
105
+ });
106
+
107
+ test('the OUTER pair guides every row of its body', () => {
108
+ // `function outer() {` … `}` spans lines 2-5.
109
+ expect(guidedLines(stateOf(DOC, DOC.indexOf('{') + 1))).toEqual([2, 3, 4, 5]);
110
+ });
111
+
112
+ test('a blank line gets no guide, so a gap reads as a gap', () => {
113
+ const doc = 'function f() {\n a();\n\n b();\n}\n';
114
+ expect(guidedLines(stateOf(doc, doc.indexOf('{') + 1))).toEqual([2, 4]);
115
+ });
116
+
117
+ test('a one-line pair draws nothing — there is no span to connect', () => {
118
+ const doc = 'if (a) { b(); }\n';
119
+ expect(guidedLines(stateOf(doc, doc.indexOf('{') + 1))).toEqual([]);
120
+ });
121
+
122
+ test('a caret with no pair draws nothing', () => {
123
+ expect(guidedLines(stateOf(DOC, DOC.indexOf('inner')))).toEqual([]);
124
+ });
125
+
126
+ test('the column is the OPENING BRACE’s, not the line’s left edge', () => {
127
+ // `function outer() {` is 18 characters and the brace is the 18th, so its
128
+ // zero-based offset is 17. A guide at the line's left edge would be 0 —
129
+ // which is an INDENT guide, a different feature.
130
+ const columns = guideColumns(stateOf(DOC, DOC.indexOf('{') + 1));
131
+ expect(columns.length).toBeGreaterThan(0);
132
+ expect(columns[0]).toBe('--bracket-guide-col: 17');
133
+ // Every row of one pair shares one column, or the rule would not be straight.
134
+ expect(new Set(columns).size).toBe(1);
135
+ });
136
+
137
+ test('a pair spanning more than MAX_GUIDE_LINES is refused rather than drawn', () => {
138
+ const body = ' x();\n'.repeat(MAX_GUIDE_LINES + 5);
139
+ const doc = `function f() {\n${body}}\n`;
140
+ expect(guidedLines(stateOf(doc, doc.indexOf('{') + 1))).toEqual([]);
141
+ });
142
+
143
+ test('a pair just inside the cap still draws', () => {
144
+ const body = ' x();\n'.repeat(20);
145
+ const doc = `function f() {\n${body}}\n`;
146
+ expect(guidedLines(stateOf(doc, doc.indexOf('{') + 1)).length).toBe(20);
147
+ });
148
+
149
+ test('the decoration is a LINE decoration, not a mark', () => {
150
+ // A mark would paint the text; the guide is a rule beside it.
151
+ const iter = bracketGuideDecorations(stateOf(DOC, DOC.indexOf('{') + 1)).iter();
152
+ const spec = iter.value?.spec as { class?: string } | undefined;
153
+ expect(spec?.class).toBe('cm-bracket-guide');
154
+ });
155
+ });
156
+
157
+ describe('stream mode table', () => {
158
+ test('every entry resolves to a real mode, through its own literal loader', async () => {
159
+ // The whole point: a typo here fails only when a user opens that language.
160
+ // Resolved through the LOADER rather than a template specifier, because that
161
+ // is the path the app takes — and the template form is exactly what never
162
+ // resolved at runtime (measured in the dev server).
163
+ const broken: string[] = [];
164
+ for (const [language, loader] of Object.entries(STREAM_MODE_LOADERS)) {
165
+ const exportName = STREAM_MODE_EXPORTS[language];
166
+ if (!exportName) {
167
+ broken.push(`${language} has a loader but no export name`);
168
+ continue;
169
+ }
170
+ try {
171
+ const module = await loader();
172
+ const mode = (module as Record<string, unknown>)[exportName];
173
+ const isMode = mode !== null && typeof mode === 'object' && typeof (mode as { token?: unknown }).token === 'function';
174
+ if (!isMode) broken.push(`${language} → export "${exportName}" is not a mode`);
175
+ } catch (error) {
176
+ broken.push(`${language} loader failed: ${error instanceof Error ? error.message : String(error)}`);
177
+ }
178
+ }
179
+ expect(broken).toEqual([]);
180
+ });
181
+
182
+ test('every Shiki language this app names is either parsed or explicitly textual', () => {
183
+ // A language added to `LANG_LOADERS` without a decision here would silently
184
+ // fall back to the textual matcher, and nothing would say so.
185
+ const decided = new Set([...Object.keys(STREAM_MODE_LOADERS), ...TEXTUAL_ONLY_LANGS]);
186
+ const undecided = Object.keys(LANG_LOADERS).filter((language) => !decided.has(language));
187
+ expect(undecided).toEqual([]);
188
+ });
189
+
190
+ test('the two sets do not overlap', () => {
191
+ const both = Object.keys(STREAM_MODE_LOADERS).filter((language) => TEXTUAL_ONLY_LANGS.includes(language));
192
+ expect(both).toEqual([]);
193
+ });
194
+
195
+ test('streamModeFor answers null for a language with no mode', () => {
196
+ expect(streamModeFor('markdown')).toBeNull();
197
+ expect(streamModeFor('graphql')).toBeNull();
198
+ expect(streamModeFor('text')).toBeNull();
199
+ });
200
+
201
+ test('streamModeFor answers the export for a covered language', () => {
202
+ // The MODULE is the loader's own literal specifier; `module` here names the
203
+ // language key, which is what the loader table is indexed by.
204
+ expect(streamModeFor('typescript')?.export).toBe('typescript');
205
+ expect(streamModeFor('bash')?.export).toBe('shell');
206
+ // And an export that does NOT match the id, which is the case a table of
207
+ // "same name" would get wrong.
208
+ expect(streamModeFor('scss')?.export).toBe('sCSS');
209
+ expect(streamModeFor('objective-c')?.export).toBe('objectiveC');
210
+ });
211
+ });
212
+
213
+ describe('a stream language makes pairing token-aware', () => {
214
+ test('a brace inside a string is not paired with the real closing brace', async () => {
215
+ // The measured failure of the textual matcher: without a mode it pairs the
216
+ // `{` with the `}` inside a string 14 characters away.
217
+ const { StreamLanguage, matchBrackets } = await import('@codemirror/language');
218
+ const rust = await import('@codemirror/legacy-modes/mode/rust');
219
+ const doc = 'fn f() {\n let s = "}";\n g();\n}\n';
220
+ const open = doc.indexOf('{');
221
+
222
+ const textual = stateOf(doc, open);
223
+ const textualMatch = matchBrackets(textual, open, 1);
224
+ expect(textualMatch?.end?.from).toBe(doc.indexOf('"}') + 1);
225
+
226
+ const parsed = EditorState.create({
227
+ doc,
228
+ extensions: [StreamLanguage.define(rust.rust as never)],
229
+ });
230
+ const parsedMatch = matchBrackets(parsed, open, 1);
231
+ expect(parsedMatch?.matched).toBe(true);
232
+ expect(parsedMatch?.end?.from).toBe(doc.lastIndexOf('}'));
233
+ });
234
+
235
+ test('the tree exists synchronously, so the guide is right on the first paint', async () => {
236
+ const { StreamLanguage, syntaxTree } = await import('@codemirror/language');
237
+ const rust = await import('@codemirror/legacy-modes/mode/rust');
238
+ const doc = 'fn f() {\n g();\n}\n';
239
+ const state = EditorState.create({ doc, extensions: [StreamLanguage.define(rust.rust as never)] });
240
+ // No `ensureSyntaxTree`, no worker: a StreamLanguage parses from the token
241
+ // stream as the state is read. Measured against a lezer grammar, whose tree
242
+ // is 3 KB until its lazy parse catches up.
243
+ expect(syntaxTree(state).length).toBe(doc.length);
244
+ });
245
+ });
246
+
247
+ // Keep the import used: `Decoration` is what the guide builds, and a test that
248
+ // asserts the class is the one that proves it.
249
+ void Decoration;
@@ -0,0 +1,131 @@
1
+ /**
2
+ * @license
3
+ * SPDX-License-Identifier: Apache-2.0
4
+ */
5
+
6
+ /**
7
+ * The bracket pair GUIDE: the vertical line from the caret's brace to its pair.
8
+ *
9
+ * `bracketMatching()` paints two characters and nothing between them. What a
10
+ * reader actually needs on a 300-line block is the SPAN — where the block ends —
11
+ * and that is a line decoration on every row in between.
12
+ *
13
+ * Three decisions, each because the alternative was measured and worse.
14
+ *
15
+ * **The guide is driven by the CARET, not by every pair in the viewport.** A
16
+ * viewport-wide version (VS Code's `bracketPairGuides`) draws a rule for every
17
+ * brace on screen: on a 337-line component that is dozens of overlapping lines,
18
+ * which is the same noise as a permanently-on indent guide and hides the one
19
+ * pair the reader is looking at. This shows the pair the caret is IN.
20
+ *
21
+ * **It reads `matchBrackets`, the same call `bracketMatching()` makes.** A second
22
+ * pairing rule would eventually disagree with the highlight, and a guide that
23
+ * points somewhere the highlight does not is worse than none.
24
+ *
25
+ * **Blank lines get no guide.** A rule through the blank line between two
26
+ * functions reads as if the block continued through it; the gap is the signal.
27
+ *
28
+ * The cost is one decoration per line of the block, rebuilt on selection and
29
+ * document changes — 4 decorations for a typical block, and the span is capped
30
+ * by `MAX_GUIDE_LINES` so a 5 000-line block cannot turn a caret move into
31
+ * thousands of ranges.
32
+ */
33
+
34
+ import { RangeSetBuilder, type EditorState } from '@codemirror/state';
35
+ import { Decoration, ViewPlugin, type DecorationSet, type EditorView } from '@codemirror/view';
36
+ import { matchBrackets } from '@codemirror/language';
37
+
38
+ /**
39
+ * How many lines a guide may span.
40
+ *
41
+ * A guide longer than this is not a block a reader is following, it is a
42
+ * container whose closing brace is off screen — and drawing it would mean one
43
+ * decoration per row of the whole file on every caret move.
44
+ */
45
+ export const MAX_GUIDE_LINES = 400;
46
+
47
+ /**
48
+ * The column the guide is drawn in: the opening brace's own, in CH.
49
+ *
50
+ * The line's text is indented, and the brace sits after whatever precedes it
51
+ * (`function f() {`), so a rule at the line's left edge would point at nothing.
52
+ * `ch` is right because the editor is monospace — measured: the surface sets
53
+ * `font-family: inherit` from a host that carries Fira Code, so one character is
54
+ * one `ch` on every row.
55
+ */
56
+ function guideColumn(state: EditorState, openPos: number): number {
57
+ const line = state.doc.lineAt(openPos);
58
+ return openPos - line.from;
59
+ }
60
+
61
+ /**
62
+ * The bracket pair the caret sits in, or null.
63
+ *
64
+ * Tries the four positions `bracketDeco` tries, in the same order, so the guide
65
+ * and the highlight can never point at different pairs.
66
+ */
67
+ export function bracketPairAt(state: EditorState): { open: number; close: number } | null {
68
+ const head = state.selection.main.head;
69
+ const attempts: Array<[number, 1 | -1]> = [
70
+ [head, -1],
71
+ [head - 1, 1],
72
+ [head, 1],
73
+ [head + 1, -1],
74
+ ];
75
+ for (const [pos, dir] of attempts) {
76
+ if (pos < 0 || pos > state.doc.length) continue;
77
+ const match = matchBrackets(state, pos, dir);
78
+ if (match?.matched && match.end) {
79
+ return { open: Math.min(match.start.from, match.end.from), close: Math.max(match.start.to, match.end.to) };
80
+ }
81
+ }
82
+ return null;
83
+ }
84
+
85
+ /** One line decoration per row the pair spans, carrying its own column. */
86
+ function guideLine(column: number): Decoration {
87
+ return Decoration.line({
88
+ class: 'cm-bracket-guide',
89
+ attributes: { style: `--bracket-guide-col: ${column}` },
90
+ });
91
+ }
92
+
93
+ /** The guide decorations for a state. Exported so a test can assert the rule. */
94
+ export function bracketGuideDecorations(state: EditorState): DecorationSet {
95
+ const pair = bracketPairAt(state);
96
+ if (!pair) return Decoration.none;
97
+
98
+ const openLine = state.doc.lineAt(pair.open);
99
+ const closeLine = state.doc.lineAt(pair.close);
100
+ // A one-line pair has nothing between its braces to connect.
101
+ if (closeLine.number - openLine.number <= 1) return Decoration.none;
102
+ if (closeLine.number - openLine.number > MAX_GUIDE_LINES) return Decoration.none;
103
+
104
+ const column = guideColumn(state, pair.open);
105
+ const decoration = guideLine(column);
106
+ const builder = new RangeSetBuilder<Decoration>();
107
+ for (let number = openLine.number + 1; number < closeLine.number; number++) {
108
+ const line = state.doc.line(number);
109
+ if (!line.text.trim()) continue;
110
+ builder.add(line.from, line.from, decoration);
111
+ }
112
+ return builder.finish();
113
+ }
114
+
115
+ const guidePlugin = ViewPlugin.fromClass(
116
+ class {
117
+ decorations: DecorationSet;
118
+
119
+ constructor(view: EditorView) {
120
+ this.decorations = bracketGuideDecorations(view.state);
121
+ }
122
+
123
+ update(update: { docChanged: boolean; selectionSet: boolean; viewportChanged: boolean; state: EditorState }) {
124
+ if (update.docChanged || update.selectionSet) this.decorations = bracketGuideDecorations(update.state);
125
+ }
126
+ },
127
+ { decorations: (plugin) => plugin.decorations },
128
+ );
129
+
130
+ /** The guide, as one extension. */
131
+ export const bracketGuide = guidePlugin;
@@ -0,0 +1,122 @@
1
+ /**
2
+ * @license
3
+ * SPDX-License-Identifier: Apache-2.0
4
+ */
5
+
6
+ /**
7
+ * The per-document state cache.
8
+ *
9
+ * The property worth pinning is the one the old single-buffer surface could not
10
+ * offer: a tab's caret, its extra cursors and its undo history belong to THAT
11
+ * tab. A cache that handed back a fresh state per call would pass a "the text is
12
+ * right" test and still lose every undo step, so these assert history and
13
+ * selection, not just the document.
14
+ *
15
+ * Driven through `EditorState` alone — `undo` is a `StateCommand`, so it takes
16
+ * `{ state, dispatch }` and needs no view, no DOM and no geometry. That is the
17
+ * whole reason the cache is a separate module: it is testable without a browser.
18
+ */
19
+
20
+ import { describe, expect, test } from 'bun:test';
21
+ import { EditorSelection } from '@codemirror/state';
22
+ import { undo } from '@codemirror/commands';
23
+ import { EditorView } from '@codemirror/view';
24
+
25
+ import { createDocumentCache } from '@/client/components/common/code-surface/documents';
26
+ import { SHIKI_THEMES } from '@/shared/lib/code/shiki-themes';
27
+
28
+ function cache(overrides: Partial<Parameters<typeof createDocumentCache>[0]> = {}) {
29
+ return createDocumentCache({
30
+ wordWrap: false,
31
+ readOnly: false,
32
+ themes: SHIKI_THEMES,
33
+ indentUnitText: ' ',
34
+ typing: { autoCloseBrackets: false, autocomplete: false },
35
+ onDocChange: () => {},
36
+ onState: () => {},
37
+ ...overrides,
38
+ });
39
+ }
40
+
41
+ /** Apply `undo` to a state the way a `Command` would, returning the new state. */
42
+ function undoOnce(state: ReturnType<ReturnType<typeof cache>['stateFor']>) {
43
+ let next = state;
44
+ undo({ state, dispatch: (transaction) => { next = transaction.state; } });
45
+ return next;
46
+ }
47
+
48
+ describe('document cache', () => {
49
+ test('an edit in one document cannot be undone from another', () => {
50
+ const documents = cache();
51
+ const first = documents.stateFor('a', 'typescript', 'const a = 1;');
52
+ const second = documents.stateFor('b', 'typescript', 'const b = 2;');
53
+
54
+ const editedFirst = first.update({ changes: { from: 0, to: 5, insert: 'let' } }).state;
55
+ const editedSecond = second.update({ changes: { from: 0, to: 5, insert: 'let' } }).state;
56
+ documents.remember('a', editedFirst);
57
+ documents.remember('b', editedSecond);
58
+
59
+ // Undo in B reverts B's own edit only. With one shared buffer this would
60
+ // have reverted whichever edit landed last.
61
+ expect(undoOnce(editedSecond).doc.toString()).toBe('const b = 2;');
62
+ expect(editedFirst.doc.toString()).toBe('let a = 1;');
63
+ });
64
+
65
+ test('a cached document comes back with its own caret', () => {
66
+ const documents = cache();
67
+ documents.stateFor('a', 'typescript', 'one\ntwo');
68
+ documents.remember('a', documents.stateFor('a', 'typescript', 'one\ntwo').update({
69
+ selection: EditorSelection.cursor(5),
70
+ }).state);
71
+
72
+ // A second document is opened in between, which is the switch a tab makes.
73
+ documents.stateFor('b', 'typescript', 'other');
74
+
75
+ expect(documents.stateFor('a', 'typescript', 'ignored').selection.main.head).toBe(5);
76
+ });
77
+
78
+ test('a cached document keeps the bytes it was last given, not the caller’s', () => {
79
+ const documents = cache();
80
+ const state = documents.stateFor('a', 'typescript', 'original');
81
+ documents.remember('a', state.update({ changes: { from: 8, to: 8, insert: '!' } }).state);
82
+
83
+ // The prop the parent passes is stale for one render after a keystroke; the
84
+ // cache must win, or every re-render would revert the character just typed.
85
+ expect(documents.stateFor('a', 'typescript', 'original').doc.toString()).toBe('original!');
86
+ });
87
+
88
+ test('drops the least recently used document past the bound', () => {
89
+ const documents = cache();
90
+ for (let index = 0; index < 20; index++) documents.stateFor(`doc-${index}`, 'typescript', `// ${index}`);
91
+ // The first document was evicted, so it comes back empty rather than with
92
+ // its old history — a closed tab's history is the intended cost.
93
+ expect(documents.stateFor('doc-0', 'typescript', 'fresh').doc.toString()).toBe('fresh');
94
+ // A recently used one is still cached.
95
+ expect(documents.stateFor('doc-19', 'typescript', 'fresh').doc.toString()).toBe('// 19');
96
+ });
97
+
98
+ test('an explicit drop forgets a closed tab', () => {
99
+ const documents = cache();
100
+ documents.stateFor('a', 'typescript', 'kept');
101
+ documents.drop('a');
102
+ expect(documents.stateFor('a', 'typescript', 'reopened').doc.toString()).toBe('reopened');
103
+ });
104
+
105
+ test('wrap and read-only changes report effects only when they moved', () => {
106
+ const documents = cache({ wordWrap: true, readOnly: false });
107
+ documents.stateFor('a', 'typescript', 'x');
108
+
109
+ expect(documents.optionsEffects({ wordWrap: true, readOnly: false, themes: SHIKI_THEMES, indentUnitText: ' ', typing: { autoCloseBrackets: false, autocomplete: false } })).toEqual([]);
110
+ expect(documents.optionsEffects({ wordWrap: false, readOnly: false, themes: SHIKI_THEMES, indentUnitText: ' ', typing: { autoCloseBrackets: false, autocomplete: false } })).toHaveLength(1);
111
+ expect(documents.optionsEffects({ wordWrap: false, readOnly: true, themes: SHIKI_THEMES, indentUnitText: ' ', typing: { autoCloseBrackets: false, autocomplete: false } })).toHaveLength(1);
112
+ });
113
+
114
+ test('a new document is created read-only when that is the current setting', () => {
115
+ const documents = cache({ readOnly: true });
116
+ const state = documents.stateFor('a', 'typescript', 'viewer');
117
+
118
+ // Both halves: `readOnly` stops the commands, `editable` stops typing.
119
+ expect(state.readOnly).toBe(true);
120
+ expect(state.facet(EditorView.editable)).toBe(false as boolean);
121
+ });
122
+ });