@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
@@ -1,348 +1,317 @@
1
- import { useCallback, useEffect, useImperativeHandle, useLayoutEffect, useMemo, useRef, useState } from 'preact/hooks';
1
+ /**
2
+ * @license
3
+ * SPDX-License-Identifier: Apache-2.0
4
+ */
5
+
6
+ /**
7
+ * The code surface: CodeMirror 6, coloured by Shiki.
8
+ *
9
+ * What this replaced, and why it is a mount rather than a component tree: the
10
+ * old surface was a transparent `<textarea>` over a Shiki-highlighted `<pre>`,
11
+ * with Kabmo's own line windowing, wrap measurement, undo stack, multi-cursor
12
+ * replication, find matcher and gutter geometry. Typing on a 4 800-line file
13
+ * cost a measured 59.6 ms median, because every keystroke re-tokenized the
14
+ * visible window and replaced the whole highlight layer's HTML; CM6 costs
15
+ * 2.1 ms and the figure is flat from 8 000 to 20 000 lines, because it renders
16
+ * and tokenizes only its viewport.
17
+ *
18
+ * Two decisions are load-bearing and both are stated elsewhere: Shiki stays the
19
+ * tokenizer (`shiki.ts` — the app has one palette, and a lezer build would cover
20
+ * 48 of the 59 ids `shiki-langs` knows), and the handle's contract is unchanged
21
+ * (`CodeSurfaceHandle`), which is what keeps the find widget, the outline jump,
22
+ * the line jump and the search reveal working without knowing about CM6.
23
+ *
24
+ * The host is a BOUNDED box. Measured: an unconstrained host grows to the
25
+ * document's height (363 758 px at 20 000 lines), and then the scroll geometry,
26
+ * the gutter and the restore path all become the outer scroller's problem. CM6
27
+ * owns its own scroller, and it hands that element to its owner through
28
+ * `onScroller` (a `ref` cannot reach a node the component does not render, and
29
+ * the restore has to re-arm when the view mounts).
30
+ */
31
+
32
+ import { useImperativeHandle, useLayoutEffect, useRef } from 'preact/hooks';
2
33
  import { forwardRef } from 'preact/compat';
3
34
  import type { CSSProperties } from 'preact';
35
+ import { EditorView } from '@codemirror/view';
4
36
 
5
- import { CodeEditor, type CodeEditorHandle } from '@/client/components/common/code-editor';
6
- import { measureRowHeight, measureWrappedLines, type WrappedLines } from '@/client/components/common/code-surface/measure';
7
- import { findScrollContainer } from '@/client/hooks/editor/scroll-container';
8
- import { useCodeWindow } from '@/client/hooks/editor/use-code-window';
9
- import { useSyntaxReady } from '@/client/hooks/ui/syntax-ready';
10
- import {
11
- measuredGeometry,
12
- shouldWindow,
13
- uniformGeometry,
14
- type LineGeometry,
15
- type LineWindow,
16
- } from '@/shared/lib/code/lazy-window';
17
- import type { FindMatch } from '@/shared/lib/code/editor/find';
18
- import type { EditorCommand } from '@/shared/lib/code/editor/keymap';
19
- import { lineIndexAt } from '@/shared/lib/code/editor/lines';
20
- import type { TextRange } from '@/shared/lib/code/editor/commands';
21
- import { countLines } from '@/shared/lib/code/editor/lines';
22
- import { highlightCode } from '@/shared/lib/code/syntax-highlight';
23
- import { highlightCodeWindow } from '@/shared/lib/code/windowed-highlight';
37
+ import { createDocumentCache, type DocumentCache } from '@/client/components/common/code-surface/documents';
38
+ import type { ShikiThemeNames } from '@/client/components/common/code-surface/shiki';
39
+ import type { CodeSurfaceProps } from '@/client/components/common/code-surface/props';
40
+ import { DEFAULT_EDITOR_TYPING } from '@/client/components/common/code-surface/typing';
41
+ import { SHIKI_THEMES } from '@/shared/lib/code/shiki-themes';
42
+ import { createSurfaceHandle, type CodeSurfaceHandle } from '@/client/components/common/code-surface/handle';
43
+ import { setFindMarks, type MarkRange } from '@/client/components/common/code-surface/marks';
44
+ import { syncExternal } from '@/client/components/common/code-surface/sync';
45
+ import { loadStreamMode, readyStreamMode } from '@/client/components/common/code-surface/stream-language';
24
46
 
25
- const WRAP_ON = '!whitespace-pre-wrap !break-words';
26
- const WRAP_OFF = '!whitespace-pre !break-normal';
47
+ export type { CodeSurfaceHandle } from '@/client/components/common/code-surface/handle';
48
+ export type { CodeSurfaceProps } from '@/client/components/common/code-surface/props';
27
49
 
28
- export interface CodeSurfaceHandle {
29
- /** Current selection offsets in the buffer, or null before the field mounts. */
30
- getSelection(): { start: number; end: number } | null;
31
- /** Select `[start, end)`; `focus` moves keyboard focus into the editor. */
32
- select(start: number, end: number, focus?: boolean): void;
33
- /** Replace the buffer as one undoable edit, caret at `[caretStart, caretEnd)`, focus unchanged. */
34
- applyDocument(value: string, caretStart: number, caretEnd: number): void;
35
- /** Run an editor command by name (the palette's path into the editor). */
36
- runCommand(command: EditorCommand): void;
50
+ export const CodeSurface = forwardRef<CodeSurfaceHandle, CodeSurfaceProps>(function CodeSurface(
51
+ {
52
+ value,
53
+ onValueChange,
54
+ language,
55
+ wordWrap,
56
+ documentKey,
57
+ marks,
58
+ currentMark,
59
+ onCommand,
60
+ readOnly = false,
61
+ themeVars,
62
+ themes,
63
+ indentUnitText = ' ',
64
+ typing = DEFAULT_EDITOR_TYPING,
65
+ style,
66
+ padding = 16,
67
+ onCaret,
68
+ scrollTestId,
69
+ onScroller,
70
+ className,
71
+ },
72
+ ref,
73
+ ) {
74
+ const hostRef = useRef<HTMLDivElement | null>(null);
75
+ const viewRef = useRef<EditorView | null>(null);
76
+ /** The document the live state holds, so a switch can park it under the right key. */
77
+ const docKeyRef = useRef<string>('');
78
+ /** The last mark signature applied, so a re-render does not re-dispatch it. */
79
+ const markSignatureRef = useRef<string>('');
37
80
  /**
38
- * Bring the line holding `offset` into view WITHOUT moving the caret — what
39
- * "step to the next match" needs: the user's focus stays in the find field
40
- * while the match scrolls under it.
81
+ * True while this component writes the buffer itself.
82
+ *
83
+ * Load-bearing: the update listener reports every document change upward, and
84
+ * an external sync (a file re-read, a tab switch) must not be reported back as
85
+ * the user's edit — the write path would then arm an autosave for a change
86
+ * nobody typed.
41
87
  */
42
- revealOffset(offset: number): void;
43
- }
44
-
45
- interface CodeSurfaceProps {
46
- value: string;
47
- onValueChange: (value: string) => void;
48
- /** Shiki language id, already resolved from the file name. */
49
- language: string;
50
- wordWrap: boolean;
51
- /** Find matches (document offsets) to paint; the current one is marked. */
52
- marks?: readonly FindMatch[];
53
- currentMark?: number;
88
+ const writingRef = useRef(false);
54
89
  /**
55
- * Extra ranges the ⌘D workflow has selected. The textarea can only hold one
56
- * selection, so the surface paints the others from here — and it must, or
57
- * ⌘D would look like it did nothing.
90
+ * The text the view last REPORTED (or last wrote), so the per-render sync can
91
+ * skip without materializing the document.
92
+ *
93
+ * `syncExternal` used to compare `value` against `doc.toString()`, which is a
94
+ * full stringify on every render — and the parent re-renders on every
95
+ * keystroke, so a large file paid it twice per character. Measured in Bun:
96
+ * `toString()` is 7.2 ms at 20 MB, 13.7 ms at 30 MB, and the browser showed
97
+ * the knee — 34 ms per keystroke at 20 MB, 67 ms at 30, 83 ms at 40. The
98
+ * parent's `value` is the very string this component handed it, so the usual
99
+ * comparison is one reference check.
58
100
  */
59
- occurrences?: readonly TextRange[];
60
- /** Commands the editor does not own (find bar chords, word wrap, save). */
61
- onCommand?: (command: EditorCommand) => void;
62
- /** Called with the extra ranges whenever ⌘D / ⌘⇧L change them. */
63
- onOccurrencesChange?: (ranges: readonly TextRange[]) => void;
64
- /** Outer flex row that holds the gutter and the editor column. */
65
- rootClassName?: string;
66
- gutterClassName?: string;
67
- gutterStyle?: CSSProperties;
68
- /** Class on each gutter line number. */
69
- gutterLineClassName?: string;
70
- /** Column wrapping the CodeEditor (padding/overflow live here). */
71
- editorWrapperClassName?: string;
72
- editorClassName?: string;
73
- editorPadding?: number;
74
- editorStyle?: CSSProperties;
75
- }
101
+ const lastValueRef = useRef(value);
76
102
 
77
- /**
78
- * The root must be as tall as the DOCUMENT, never as tall as the scroller it
79
- * sits in.
80
- *
81
- * Both callers put this surface inside a scroll container, and the desktop
82
- * editor's is `display: flex` — so the default `align-items: stretch` sized the
83
- * root to the container's viewport height while its content (the highlighted
84
- * `<pre>`, one box per line) overflowed it. The gutter is a stretched row of
85
- * that root, so its `bg-canvas` band and its `border-r` rule ended after one
86
- * viewport's worth of lines: scrolling a long file left the line numbers
87
- * painting over the scroller's own background, with the divider gone. Measured
88
- * on a 368-line file in a 770px pane — the gutter's box stayed 770px tall at
89
- * every scroll offset while the document was 10 218px.
90
- *
91
- * `align-self: flex-start` is what escapes the stretch; `min-height: 100%` is
92
- * the floor that keeps a SHORT document's gutter full-height. Together they
93
- * give the box the height the phone's layout already had (`min-h-full` inside a
94
- * non-flex scroller), so the two layouts no longer differ here — and the rule
95
- * lives in the component, because it is a property of the surface, not of a
96
- * caller's chrome. `align-self` is inert outside a flex parent.
97
- */
98
- const ROOT_STYLE: CSSProperties = { alignSelf: 'flex-start', minHeight: '100%' };
103
+ // Live mirrors: the state's own extensions close over these, and rebuilding
104
+ // the state because a callback identity moved would drop the undo history.
105
+ const onChangeRef = useRef(onValueChange);
106
+ onChangeRef.current = onValueChange;
107
+ const onCommandRef = useRef(onCommand);
108
+ onCommandRef.current = onCommand;
109
+ const onScrollerRef = useRef(onScroller);
110
+ onScrollerRef.current = onScroller;
111
+ const onCaretRef = useRef(onCaret);
112
+ onCaretRef.current = onCaret;
113
+ /** The marks as of the last render, for the re-apply a document switch owes. */
114
+ const marksRef = useRef<readonly MarkRange[]>(marks ?? []);
115
+ const currentMarkRef = useRef(currentMark ?? -1);
116
+ marksRef.current = marks ?? [];
117
+ currentMarkRef.current = currentMark ?? -1;
118
+ /** The tokenizer themes, mirrored for the cache's first build. */
119
+ const activeThemes = themes ?? SHIKI_THEMES;
120
+ const themesRef = useRef<ShikiThemeNames>(activeThemes);
121
+ themesRef.current = activeThemes;
122
+ /** The indentation unit, mirrored for the cache's first build. */
123
+ const indentRef = useRef(indentUnitText);
124
+ indentRef.current = indentUnitText;
125
+ const typingRef = useRef(typing);
126
+ typingRef.current = typing;
99
127
 
100
- /** Same measurement, so a re-render does not resize every gutter row. */
101
- function sameWrappedLines(previous: WrappedLines | null, next: WrappedLines | null): boolean {
102
- if (previous === next) return true;
103
- if (!previous || !next || previous.rowHeight !== next.rowHeight) return false;
104
- return (
105
- previous.heights.length === next.heights.length &&
106
- previous.heights.every((height, index) => height === next.heights[index])
107
- );
108
- }
128
+ // One cache for the component's life: it owns the per-document states.
129
+ const cacheRef = useRef<DocumentCache | null>(null);
130
+ if (!cacheRef.current) {
131
+ cacheRef.current = createDocumentCache({
132
+ wordWrap,
133
+ readOnly,
134
+ themes: themesRef.current,
135
+ indentUnitText: indentRef.current,
136
+ typing: typingRef.current,
137
+ onDocChange: (next) => {
138
+ // Recorded BEFORE the writing guard: this is what the document holds,
139
+ // whether or not the change came from the user.
140
+ lastValueRef.current = next;
141
+ if (writingRef.current) return;
142
+ onChangeRef.current(next);
143
+ },
144
+ onState: (state) => {
145
+ const key = docKeyRef.current;
146
+ if (key) cacheRef.current?.remember(key, state);
147
+ },
148
+ onCommand: (command) => onCommandRef.current?.(command),
149
+ onCaret: (position) => onCaretRef.current?.(position),
150
+ });
151
+ }
109
152
 
110
- /**
111
- * The line-number gutter + syntax-highlighted editing surface shared by the
112
- * desktop editor and the phone's full-screen editor. Callers own only the
113
- * layout classes (padding, font, zoom) that genuinely differ per layout; the
114
- * gutter, word-wrap behaviour and Shiki highlighting live here so the two
115
- * surfaces cannot drift.
116
- *
117
- * The gutter spaces its numbers from the editor's measured wrap layout: with
118
- * word wrap on, a long line covers several rows and every number below it has
119
- * to move down by the same amount.
120
- *
121
- * A long document is drawn lazily: only the lines inside the scroll container's
122
- * viewport are highlighted and numbered, and the space of everything else is
123
- * reserved from the same geometry the caret is aligned to. That keeps opening a
124
- * 20 000-line file from spending minutes in the tokenizer, and a keystroke in it
125
- * from re-tokenizing the file at all.
126
- */
127
- export const CodeSurface = forwardRef<CodeSurfaceHandle, CodeSurfaceProps>(function CodeSurface({
128
- value,
129
- onValueChange,
130
- language,
131
- wordWrap,
132
- marks,
133
- currentMark,
134
- occurrences,
135
- onCommand,
136
- onOccurrencesChange,
137
- rootClassName,
138
- gutterClassName,
139
- gutterStyle,
140
- gutterLineClassName,
141
- editorWrapperClassName,
142
- editorClassName,
143
- editorPadding = 0,
144
- editorStyle,
145
- }, ref) {
146
- const wrapClass = wordWrap ? WRAP_ON : WRAP_OFF;
147
- const preRef = useRef<HTMLPreElement | null>(null);
148
- const rootRef = useRef<HTMLDivElement | null>(null);
149
- const editorRef = useRef<CodeEditorHandle | null>(null);
150
- const [wrapped, setWrapped] = useState<WrappedLines | null>(null);
151
- const [rowHeight, setRowHeight] = useState<number | null>(null);
152
- /** Lines the last measurement pass described; -1 before the first one runs. */
153
- const [measuredLines, setMeasuredLines] = useState(-1);
154
- useSyntaxReady();
153
+ // Mount once. Every later change is a state swap or a dispatch — never a
154
+ // second view, which would drop the undo history the cache exists to keep.
155
+ useLayoutEffect(() => {
156
+ const host = hostRef.current;
157
+ const cache = cacheRef.current;
158
+ if (!host || !cache) return;
155
159
 
156
- const lineCount = useMemo(() => countLines(value), [value]);
160
+ docKeyRef.current = documentKey;
161
+ const view = new EditorView({
162
+ state: cache.stateFor(documentKey, language, value),
163
+ parent: host,
164
+ });
165
+ viewRef.current = view;
166
+ lastValueRef.current = value;
167
+ if (scrollTestId) view.scrollDOM.dataset.testid = scrollTestId;
168
+ onScrollerRef.current?.(view.scrollDOM);
169
+ // The caret is reported by the UPDATE listener, which only fires when something
170
+ // moves — so a freshly mounted document would report nothing and a status readout
171
+ // would print its empty state over a file that has a caret. Seeded here, once.
172
+ const start = view.state.doc.lineAt(view.state.selection.main.head);
173
+ onCaretRef.current?.({
174
+ line: start.number,
175
+ column: view.state.selection.main.head - start.from + 1,
176
+ });
157
177
 
158
- // Re-measured on the inputs that move a wrap point: the text, the wrap
159
- // preference, and the editor's font size / padding.
160
- const measure = useCallback(() => {
161
- const pre = preRef.current;
162
- if (!pre) return;
163
- // Wrapped heights are only needed with word wrap on; without it every line
164
- // is one row and the row height alone describes the document.
165
- const next = wordWrap ? measureWrappedLines(pre, value) : null;
166
- setWrapped((previous) => (sameWrappedLines(previous, next) ? previous : next));
167
- const height = next?.rowHeight ?? measureRowHeight(pre);
168
- setRowHeight((previous) => (previous === height ? previous : height));
169
- setMeasuredLines(lineCount);
178
+ return () => {
179
+ onScrollerRef.current?.(null);
180
+ view.destroy();
181
+ viewRef.current = null;
182
+ };
183
+ // Mount only: the effects below own every later change, and re-running this
184
+ // one would rebuild the view (and its history).
170
185
  // eslint-disable-next-line react-hooks/exhaustive-deps
171
- }, [value, lineCount, wordWrap, editorPadding, editorStyle?.fontSize]);
172
-
173
- useLayoutEffect(() => {
174
- measure();
175
- }, [measure]);
176
-
177
- // The wrap width also changes without a re-render — dragging the panel
178
- // splitter, resizing the window, a zoom that reflows — so the editor's own
179
- // box drives a re-measure too.
180
- const measureRef = useRef(measure);
181
- measureRef.current = measure;
182
- useEffect(() => {
183
- const pre = preRef.current;
184
- if (!pre || typeof ResizeObserver === 'undefined') return;
185
- const observer = new ResizeObserver(() => measureRef.current());
186
- observer.observe(pre);
187
- return () => observer.disconnect();
188
186
  }, []);
189
187
 
190
- const geometry = useMemo<LineGeometry | null>(() => {
191
- if (rowHeight === null) return null;
192
- return wrapped
193
- ? measuredGeometry(wrapped.heights, wrapped.rowHeight, lineCount)
194
- : uniformGeometry(rowHeight, lineCount);
195
- }, [rowHeight, wrapped, lineCount]);
196
-
197
- // Windowing costs a scroll listener and a spacer; a document short enough to
198
- // draw in one pass keeps the plain surface.
199
- const lazy = shouldWindow(lineCount, value.length);
200
- const virtual = useCodeWindow({
201
- rootRef,
202
- lineCount,
203
- geometry,
204
- // A document whose geometry could not be measured still falls back to the
205
- // plain surface — but one whose measurement has not run *yet* must not:
206
- // that path would draw the whole file, which is what windowing exists to
207
- // avoid. `measuredLines` is why switching files (which leaves a geometry
208
- // for the previous document behind) does not take it either.
209
- enabled: lazy && (measuredLines !== lineCount || geometry !== null),
210
- });
188
+ // A different document: park the live state, then apply the other one.
189
+ useLayoutEffect(() => {
190
+ const view = viewRef.current;
191
+ const cache = cacheRef.current;
192
+ if (!view || !cache) return;
193
+ if (docKeyRef.current === documentKey) return;
194
+ cache.remember(docKeyRef.current, view.state);
195
+ docKeyRef.current = documentKey;
196
+ view.setState(cache.stateFor(documentKey, language, value));
197
+ // The cached state carries the configuration it was CREATED with, and
198
+ // `setState` installs that wholesale — so the current wrap/read-only pair
199
+ // and the current editor theme are re-applied, or a tab opened while wrap
200
+ // was off comes back unwrapped and a theme chosen since comes back stale.
201
+ view.dispatch({ effects: cache.currentEffects(documentKey) });
202
+ syncExternal(view, value, writingRef, lastValueRef);
203
+ // The other document's caret, not the one this view was showing: a status
204
+ // readout that kept the previous tab's line number would be describing a file
205
+ // that is no longer on screen.
206
+ const restored = view.state.doc.lineAt(view.state.selection.main.head);
207
+ onCaretRef.current?.({
208
+ line: restored.number,
209
+ column: view.state.selection.main.head - restored.from + 1,
210
+ });
211
+ // The marks belonged to the previous document's offsets, and the field lives
212
+ // in that state. A fresh state starts empty, so this re-applies whatever the
213
+ // new document's owner asked for rather than leaving a stale set behind.
214
+ markSignatureRef.current = '';
215
+ view.dispatch({
216
+ effects: setFindMarks.of({ marks: marksRef.current, current: currentMarkRef.current }),
217
+ });
218
+ // `value` is deliberately absent: this effect is about the KEY moving, and
219
+ // the external sync below covers a document whose bytes were replaced.
220
+ // eslint-disable-next-line react-hooks/exhaustive-deps
221
+ }, [documentKey]);
211
222
 
212
- /**
213
- * What the highlight layer paints: the find matches, plus every extra ⌘D
214
- * range. The find widget's current match is the one the caret is aimed at, so
215
- * it keeps `currentMark` — an occurrence range never claims that role.
216
- */
217
- const painted = useMemo<readonly FindMatch[]>(() => {
218
- if (!occurrences || occurrences.length === 0) return marks ?? [];
219
- return [...(marks ?? []), ...occurrences];
220
- }, [marks, occurrences]);
221
- /** Where the extra selections start inside `painted`; -1 when there are none. */
222
- const occurrenceFrom = occurrences && occurrences.length > 0 ? (marks?.length ?? 0) : -1;
223
+ // The parent replaced the buffer (a re-read, a refresh, a replace-all).
224
+ useLayoutEffect(() => {
225
+ const view = viewRef.current;
226
+ if (!view || docKeyRef.current !== documentKey) return;
227
+ syncExternal(view, value, writingRef, lastValueRef);
228
+ }, [value, documentKey]);
223
229
 
224
- const highlight = useCallback(
225
- (code: string, range: LineWindow | null) =>
226
- range
227
- ? highlightCodeWindow(code, language, range, { marks: painted, currentMark, occurrenceFrom })
228
- : highlightCode(code, language, { marks: painted, currentMark, occurrenceFrom }),
229
- [language, painted, currentMark, occurrenceFrom],
230
- );
230
+ // Wrap, read-only and the editor theme are per-view settings: reconfiguring
231
+ // keeps the document, the selection and the history, which is what a wrap
232
+ // toggle — or a colour change — must not disturb.
233
+ useLayoutEffect(() => {
234
+ const view = viewRef.current;
235
+ const cache = cacheRef.current;
236
+ if (!view || !cache) return;
237
+ const effects = cache.optionsEffects(
238
+ { wordWrap, readOnly, themes: activeThemes, indentUnitText, typing },
239
+ docKeyRef.current,
240
+ );
241
+ if (effects.length > 0) view.dispatch({ effects });
242
+ }, [wordWrap, readOnly, activeThemes.light, activeThemes.dark, indentUnitText, typing]);
231
243
 
232
244
  /**
233
- * Bring `offset`'s row into view without touching the caret.
245
+ * The stream language: fetched for this document's language, installed when it
246
+ * lands.
234
247
  *
235
- * `scrollIntoView` cannot be used: the caret's row and the match's row are
236
- * different elements (the highlighted `<pre>` is `aria-hidden` and
237
- * `pointer-events: none`), and the browser's own scroll-into-view on
238
- * `setSelectionRange` would fight this. Instead the row's pixel offset comes
239
- * from the same geometry the window is resolved against, so the two agree by
240
- * construction, and the scroll is a plain assignment on the container the
241
- * window reads.
248
+ * The mode is a lazy import, so the document was created without a parser and
249
+ * `bracketMatching()` answers textually until this reconfigure runs. A mode
250
+ * that fails to load leaves that textual matcher, which is a worse answer
251
+ * rather than a broken editor — `loadStreamMode` never rejects.
242
252
  *
243
- * A reveal is REPLAYED while the geometry is still moving, and that is
244
- * load-bearing rather than defensive. Opening the editor panel animates its
245
- * width, so the document is measured once at each intermediate width: a
246
- * reveal that scrolled with the first (narrow) measurement put line 800 of a
247
- * 900-line file near the bottom, and the settled, wider measurement then left
248
- * the scroller clamped there — showing the file's tail with the hit's own
249
- * highlight unpainted.
253
+ * Re-installed on a DOCUMENT SWITCH too: the compartment is per state, and a
254
+ * cached tab coming back has whatever configuration it was created with.
250
255
  */
251
- const pendingRevealRef = useRef<{ offset: number; until: number } | null>(null);
256
+ useLayoutEffect(() => {
257
+ const view = viewRef.current;
258
+ const cache = cacheRef.current;
259
+ if (!view || !cache) return;
252
260
 
253
- const applyReveal = useCallback(
254
- (offset: number) => {
255
- const root = rootRef.current;
256
- if (!root || !geometry) return;
257
- const rowTop = geometry.offsetOf(lineIndexAt(value, offset));
258
- const container = findScrollContainer(root);
259
- if (!container) return;
260
- const frameTop = root.getBoundingClientRect().top - container.getBoundingClientRect().top + container.scrollTop;
261
- const band = container.clientHeight;
262
- const target = frameTop + rowTop;
263
- // Only scroll when the row is actually outside the band; a reveal that
264
- // always re-centers would make every "next match" jump the whole view.
265
- if (target < container.scrollTop + 8 || target + geometry.rowHeight > container.scrollTop + band - 8) {
266
- container.scrollTop = Math.max(0, target - band / 3);
267
- }
268
- },
269
- [geometry, value],
270
- );
261
+ let cancelled = false;
262
+ const install = (mode: unknown) => {
263
+ if (cancelled || !mode) return;
264
+ const live = viewRef.current;
265
+ if (!live) return;
266
+ const effects = cache.languageEffects(docKeyRef.current, mode as never);
267
+ if (effects.length > 0) live.dispatch({ effects });
268
+ };
271
269
 
272
- const revealOffset = useCallback(
273
- (offset: number) => {
274
- // The window covers the panel's 200ms width transition plus a margin; a
275
- // user scrolling within it is not a case this feature has to serve.
276
- pendingRevealRef.current = { offset, until: performance.now() + 600 };
277
- applyReveal(offset);
278
- },
279
- [applyReveal],
280
- );
270
+ // Already loaded (a second tab in the same language): install immediately so
271
+ // the tree exists on the first paint, not one microtask later.
272
+ const ready = readyStreamMode(language);
273
+ if (ready) {
274
+ install(ready);
275
+ return () => { cancelled = true; };
276
+ }
277
+
278
+ void loadStreamMode(language).then(install);
279
+ return () => { cancelled = true; };
280
+ }, [language, documentKey]);
281
281
 
282
- // Re-apply the pending reveal as the geometry moves, and drop it once the
283
- // document has settled (or the window closed).
282
+ // Find marks: a field write, never a re-tokenize.
284
283
  useLayoutEffect(() => {
285
- const pending = pendingRevealRef.current;
286
- if (!pending) return;
287
- if (performance.now() > pending.until) {
288
- pendingRevealRef.current = null;
289
- return;
290
- }
291
- applyReveal(pending.offset);
292
- }, [applyReveal]);
284
+ const view = viewRef.current;
285
+ if (!view) return;
286
+ const list = marks ?? [];
287
+ const signature = `${currentMark ?? -1}:${list.map((mark) => `${mark.start}-${mark.end}`).join(',')}`;
288
+ if (signature === markSignatureRef.current) return;
289
+ markSignatureRef.current = signature;
290
+ view.dispatch({ effects: setFindMarks.of({ marks: list, current: currentMark ?? -1 }) });
291
+ }, [marks, currentMark]);
293
292
 
294
- useImperativeHandle(
295
- ref,
296
- () => ({
297
- getSelection: () => editorRef.current?.getSelection() ?? null,
298
- select: (start, end, focus = true) => editorRef.current?.select(start, end, focus),
299
- applyDocument: (next, caretStart, caretEnd) => editorRef.current?.applyDocument(next, caretStart, caretEnd),
300
- runCommand: (command) => editorRef.current?.run(command),
301
- revealOffset,
302
- }),
303
- [revealOffset],
304
- );
293
+ // Built once: the handle closes over refs, so a consumer holding it never
294
+ // re-subscribes, and the view it reaches is whatever is live at the call.
295
+ useImperativeHandle(ref, () => createSurfaceHandle({ view: viewRef, onCommand: onCommandRef }), []);
305
296
 
306
- const firstLine = virtual ? virtual.start : 0;
307
- const lastLine = virtual ? Math.min(virtual.end, lineCount) : lineCount;
308
- const rows: number[] = [];
309
- for (let i = firstLine; i < lastLine; i++) rows.push(i);
310
- // Row heights are only usable for the document they were measured against.
311
- const lineHeights = wrapped && wrapped.heights.length === lineCount ? wrapped.heights : null;
297
+ const hostStyle = {
298
+ ...themeVars,
299
+ ...style,
300
+ // The document's padding, read back by the theme as a CSS variable so a
301
+ // per-layout value needs no theme reconfigure.
302
+ '--surface-pad': `${padding}px`,
303
+ } as CSSProperties;
312
304
 
313
305
  return (
314
- <div className={rootClassName} style={ROOT_STYLE} ref={rootRef}>
315
- <div className={gutterClassName} style={gutterStyle}>
316
- {virtual && virtual.top > 0 ? <div style={{ height: virtual.top, flexShrink: 0 }} aria-hidden="true" /> : null}
317
- {rows.map((index) => (
318
- <div
319
- key={index + 1}
320
- className={gutterLineClassName}
321
- style={lineHeights ? { height: lineHeights[index], flexShrink: 0 } : undefined}
322
- >
323
- {index + 1}
324
- </div>
325
- ))}
326
- </div>
327
- <div className={editorWrapperClassName}>
328
- <CodeEditor
329
- value={value}
330
- onValueChange={onValueChange}
331
- highlight={highlight}
332
- padding={editorPadding}
333
- preRef={preRef}
334
- handleRef={editorRef}
335
- textareaClassName={`focus:outline-none ${wrapClass}`}
336
- preClassName={wrapClass}
337
- style={editorStyle}
338
- className={editorClassName}
339
- virtual={virtual}
340
- language={language}
341
- occurrences={occurrences}
342
- onCommand={onCommand}
343
- onOccurrencesChange={onOccurrencesChange}
344
- />
345
- </div>
346
- </div>
306
+ <div
307
+ ref={hostRef}
308
+ className={className}
309
+ style={hostStyle}
310
+ // The panel's drop handler claims a file drop in the CAPTURE phase when
311
+ // the drag is over this element: CodeMirror's own `drop` handler inserts a
312
+ // dropped file's TEXT into the document, which would rewrite the open file
313
+ // on the next autosave. See `use-editor-drop.ts`.
314
+ data-code-surface=""
315
+ />
347
316
  );
348
317
  });