@kabmo-labs/kabmo 0.8.0 → 0.10.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (391) hide show
  1. package/README.md +52 -0
  2. package/dist/client/index.html +1 -1
  3. package/dist/client/index.js +336 -336
  4. package/dist/client/static/js/index-18xe7655.css +1 -0
  5. package/dist/client/static/js/{index-qwpvd9fv.js → index-nxpe7835.js} +933 -898
  6. package/package.json +11 -1
  7. package/src/client/components/common/code-surface/bracket-guide.test.ts +249 -0
  8. package/src/client/components/common/code-surface/bracket-guide.ts +131 -0
  9. package/src/client/components/common/code-surface/documents.test.ts +122 -0
  10. package/src/client/components/common/code-surface/documents.ts +286 -0
  11. package/src/client/components/common/code-surface/extensions.test.ts +115 -0
  12. package/src/client/components/common/code-surface/extensions.ts +295 -0
  13. package/src/client/components/common/code-surface/fold-stack.test.ts +218 -0
  14. package/src/client/components/common/code-surface/fold.test.ts +148 -0
  15. package/src/client/components/common/code-surface/fold.ts +118 -0
  16. package/src/client/components/common/code-surface/handle.ts +102 -0
  17. package/src/client/components/common/code-surface/indent-guide.ts +104 -0
  18. package/src/client/components/common/code-surface/indent.test.ts +239 -0
  19. package/src/client/components/common/code-surface/indent.ts +124 -0
  20. package/src/client/components/common/code-surface/index.tsx +283 -314
  21. package/src/client/components/common/code-surface/keymap.test.ts +133 -0
  22. package/src/client/components/common/code-surface/keymap.ts +256 -0
  23. package/src/client/components/common/code-surface/line-commands.test.ts +90 -0
  24. package/src/client/components/common/code-surface/line-commands.ts +103 -0
  25. package/src/client/components/common/code-surface/marks.ts +74 -0
  26. package/src/client/components/common/code-surface/props.ts +87 -0
  27. package/src/client/components/common/code-surface/shiki.ts +234 -0
  28. package/src/client/components/common/code-surface/stream-language.test.ts +118 -0
  29. package/src/client/components/common/code-surface/stream-language.ts +123 -0
  30. package/src/client/components/common/code-surface/sync.test.ts +185 -0
  31. package/src/client/components/common/code-surface/sync.ts +58 -0
  32. package/src/client/components/common/code-surface/theme.test.ts +237 -0
  33. package/src/client/components/common/code-surface/theme.ts +224 -0
  34. package/src/client/components/common/code-surface/typing.test.ts +97 -0
  35. package/src/client/components/common/code-surface/typing.ts +111 -0
  36. package/src/client/components/common/editor-view-buttons/index.test.tsx +148 -0
  37. package/src/client/components/common/editor-view-buttons/index.tsx +109 -0
  38. package/src/client/components/common/shell-update-button/Modal.tsx +163 -0
  39. package/src/client/components/common/shell-update-button/index.test.tsx +251 -0
  40. package/src/client/components/common/shell-update-button/index.tsx +125 -0
  41. package/src/client/components/common/toolbar-row/index.test.tsx +215 -0
  42. package/src/client/components/common/toolbar-row/index.tsx +260 -0
  43. package/src/client/components/layout/desktop-layout/WorkspacePanels.tsx +58 -78
  44. package/src/client/components/layout/desktop-layout/index.tsx +65 -67
  45. package/src/client/components/layout/desktop-layout/resizer/index.tsx +6 -3
  46. package/src/client/components/layout/session-sidebar/Footer.tsx +8 -15
  47. package/src/client/components/mobile/LayoutWrapper.tsx +1 -0
  48. package/src/client/components/mobile/mobile-right-sidebar/FullDiff.tsx +3 -0
  49. package/src/client/components/mobile/mobile-right-sidebar/FullEditor.tsx +98 -71
  50. package/src/client/components/mobile/mobile-right-sidebar/Header.tsx +20 -1
  51. package/src/client/components/mobile/mobile-right-sidebar/OutlineButton.test.tsx +137 -0
  52. package/src/client/components/mobile/mobile-right-sidebar/OutlineButton.tsx +14 -3
  53. package/src/client/components/mobile/mobile-right-sidebar/editor-props.ts +25 -0
  54. package/src/client/components/mobile/mobile-session-sidebar/Footer.tsx +9 -21
  55. package/src/client/components/settings/Modal.tsx +8 -0
  56. package/src/client/components/settings/categories/AppearanceSettings.tsx +9 -0
  57. package/src/client/components/settings/categories/appearance-settings/EditorIndentSection.tsx +87 -0
  58. package/src/client/components/settings/categories/appearance-settings/EditorThemeSection.test.tsx +167 -0
  59. package/src/client/components/settings/categories/appearance-settings/EditorThemeSection.tsx +184 -0
  60. package/src/client/components/settings/categories/appearance-settings/EditorTypingSection.tsx +99 -0
  61. package/src/client/components/settings/categories/project-settings/WorktreeSettings.tsx +8 -2
  62. package/src/client/components/workspace/chat-timeline/EmptyWorkspacePrompt.tsx +16 -8
  63. package/src/client/components/workspace/chat-timeline/SystemNotice.tsx +9 -4
  64. package/src/client/components/workspace/chat-timeline/TaskResultContent.tsx +9 -7
  65. package/src/client/components/workspace/chat-timeline/chat-input/expansion.ts +9 -4
  66. package/src/client/components/workspace/chat-timeline/chat-input/index.tsx +15 -11
  67. package/src/client/components/workspace/chat-timeline/chat-input/stretch-send.test.tsx +165 -0
  68. package/src/client/components/workspace/chat-timeline/target-picker/WorkspacePicker.test.tsx +132 -0
  69. package/src/client/components/workspace/chat-timeline/target-picker/WorkspacePicker.tsx +120 -0
  70. package/src/client/components/workspace/chat-timeline/target-picker/WorktreePicker.test.tsx +319 -0
  71. package/src/client/components/workspace/chat-timeline/target-picker/WorktreePicker.tsx +285 -0
  72. package/src/client/components/workspace/chat-timeline/tool-renderers/ask-panel/index.test.ts +2 -0
  73. package/src/client/components/workspace/chat-timeline/tool-renderers/hashline-patch/index.tsx +34 -29
  74. package/src/client/components/workspace/chat-timeline/tool-renderers/panels/AstEdit.tsx +11 -9
  75. package/src/client/components/workspace/chat-timeline/tool-renderers/panels/Bash.tsx +10 -7
  76. package/src/client/components/workspace/chat-timeline/tool-renderers/panels/Edit.tsx +25 -8
  77. package/src/client/components/workspace/chat-timeline/tool-renderers/panels/Eval.tsx +8 -11
  78. package/src/client/components/workspace/chat-timeline/tool-renderers/panels/FileMatches.test.ts +114 -0
  79. package/src/client/components/workspace/chat-timeline/tool-renderers/panels/FileMatches.tsx +111 -0
  80. package/src/client/components/workspace/chat-timeline/tool-renderers/panels/Read.tsx +7 -7
  81. package/src/client/components/workspace/chat-timeline/tool-renderers/panels/SearchTool.tsx +9 -59
  82. package/src/client/components/workspace/chat-timeline/tool-renderers/shared/ArtifactBody.tsx +2 -7
  83. package/src/client/components/workspace/chat-timeline/tool-renderers/shared/DiffView.test.ts +43 -30
  84. package/src/client/components/workspace/chat-timeline/tool-renderers/shared/DiffView.tsx +49 -32
  85. package/src/client/components/workspace/chat-timeline/tool-renderers/shared/ExcerptCode.tsx +8 -8
  86. package/src/client/components/workspace/chat-timeline/tool-renderers/shared/HighlightedCode.tsx +35 -0
  87. package/src/client/components/workspace/chat-timeline/tool-renderers/shared/JsonCodeBlock.tsx +4 -4
  88. package/src/client/components/workspace/diff-panel/MergeDiffView.tsx +179 -0
  89. package/src/client/components/workspace/diff-panel/ThemedMergeDiffView.tsx +24 -0
  90. package/src/client/components/workspace/diff-panel/Toolbar.tsx +224 -186
  91. package/src/client/components/workspace/diff-panel/ToolbarSegments.tsx +98 -0
  92. package/src/client/components/workspace/diff-panel/index.tsx +76 -145
  93. package/src/client/components/workspace/diff-panel/merge.ts +315 -0
  94. package/src/client/components/workspace/editor/Body.tsx +28 -7
  95. package/src/client/components/workspace/editor/CommandPalette.tsx +6 -6
  96. package/src/client/components/workspace/editor/ConflictStrip.tsx +77 -0
  97. package/src/client/components/workspace/editor/Dialogs.tsx +53 -0
  98. package/src/client/components/workspace/editor/EmptyEditor.tsx +23 -0
  99. package/src/client/components/workspace/editor/ExternalChangeStrip.tsx +61 -0
  100. package/src/client/components/workspace/editor/FileDocument.tsx +146 -63
  101. package/src/client/components/workspace/editor/FilePane.tsx +47 -7
  102. package/src/client/components/workspace/editor/FindWidget.test.ts +9 -5
  103. package/src/client/components/workspace/editor/FindWidget.tsx +36 -2
  104. package/src/client/components/workspace/editor/GoToLineModal.tsx +123 -0
  105. package/src/client/components/workspace/editor/Notices.tsx +71 -0
  106. package/src/client/components/workspace/editor/Pane.tsx +118 -0
  107. package/src/client/components/workspace/editor/PluginColumn.tsx +32 -0
  108. package/src/client/components/workspace/editor/QuickOpenModal.tsx +146 -0
  109. package/src/client/components/workspace/editor/SaveAsModal.tsx +175 -0
  110. package/src/client/components/workspace/editor/SplitColumn.tsx +98 -0
  111. package/src/client/components/workspace/editor/SplitPane.tsx +57 -0
  112. package/src/client/components/workspace/editor/StatusBar.tsx +106 -0
  113. package/src/client/components/workspace/editor/TabContextMenu.tsx +75 -0
  114. package/src/client/components/workspace/editor/Tabs.tsx +195 -18
  115. package/src/client/components/workspace/editor/Toolbar.tsx +110 -140
  116. package/src/client/components/workspace/editor/index.tsx +201 -193
  117. package/src/client/components/workspace/editor/props.ts +64 -0
  118. package/src/client/components/workspace/editor/toolbar-clusters.tsx +300 -0
  119. package/src/client/components/workspace/file-explorer/Modals.tsx +14 -1
  120. package/src/client/components/workspace/file-explorer/OutlineSection.test.tsx +18 -0
  121. package/src/client/components/workspace/file-explorer/OutlineSection.tsx +10 -3
  122. package/src/client/components/workspace/file-explorer/TreeItem.tsx +2 -1
  123. package/src/client/components/workspace/file-explorer/clipboard.test.ts +3 -1
  124. package/src/client/components/workspace/file-explorer/index.test.ts +61 -0
  125. package/src/client/components/workspace/file-explorer/index.tsx +10 -48
  126. package/src/client/components/workspace/file-explorer/local-edit.test.ts +8 -3
  127. package/src/client/components/workspace/search-panel/Body.tsx +7 -2
  128. package/src/client/components/workspace/worktree-modal/index.test.tsx +118 -0
  129. package/src/client/hooks/chat/composer/file-drop.ts +22 -37
  130. package/src/client/hooks/chat/composer/pipeline.test.ts +76 -0
  131. package/src/client/hooks/chat/composer/pipeline.ts +12 -1
  132. package/src/client/hooks/chat/omp/reconnect.test.ts +338 -0
  133. package/src/client/hooks/chat/omp/reconnect.ts +187 -0
  134. package/src/client/hooks/chat/omp/run-liveness.test.ts +71 -0
  135. package/src/client/hooks/chat/omp/run-liveness.ts +65 -0
  136. package/src/client/hooks/chat/omp/session-list.activity.test.ts +114 -0
  137. package/src/client/hooks/chat/omp/session-list.test-util.ts +164 -0
  138. package/src/client/hooks/chat/omp/session-list.test.ts +30 -150
  139. package/src/client/hooks/chat/omp/session-list.tsx +69 -9
  140. package/src/client/hooks/chat/timeline/generating.ts +19 -2
  141. package/src/client/hooks/chat/timeline/index.ts +19 -24
  142. package/src/client/hooks/chat/timeline/lost-run.test.ts +329 -0
  143. package/src/client/hooks/chat/timeline/lost-run.ts +177 -0
  144. package/src/client/hooks/chat/timeline/session-load.test-util.ts +205 -0
  145. package/src/client/hooks/chat/timeline/session-load.test.ts +61 -162
  146. package/src/client/hooks/chat/timeline/session-load.ts +69 -37
  147. package/src/client/hooks/chat/timeline/session-switch.test.ts +65 -0
  148. package/src/client/hooks/chat/timeline/session-switch.ts +63 -0
  149. package/src/client/hooks/code/deferred-highlight.test.ts +182 -0
  150. package/src/client/hooks/code/deferred-highlight.ts +129 -0
  151. package/src/client/hooks/editor/caret-position.test.ts +58 -0
  152. package/src/client/hooks/editor/caret-position.ts +48 -0
  153. package/src/client/hooks/editor/file-editor-types.ts +200 -0
  154. package/src/client/hooks/editor/find-history.test.ts +132 -0
  155. package/src/client/hooks/editor/find-history.ts +46 -0
  156. package/src/client/hooks/editor/find-selection-range.test.ts +100 -0
  157. package/src/client/hooks/editor/find-selection-range.ts +49 -0
  158. package/src/client/hooks/editor/find-state.ts +14 -1
  159. package/src/client/hooks/editor/font.test.ts +0 -93
  160. package/src/client/hooks/editor/indent-settings.test.ts +104 -0
  161. package/src/client/hooks/editor/indent-settings.ts +88 -0
  162. package/src/client/hooks/editor/quick-open.test.ts +141 -0
  163. package/src/client/hooks/editor/quick-open.ts +127 -0
  164. package/src/client/hooks/editor/save-as.test.ts +156 -0
  165. package/src/client/hooks/editor/save-as.ts +122 -0
  166. package/src/client/hooks/editor/save-file.test.ts +179 -0
  167. package/src/client/hooks/editor/save-file.ts +73 -28
  168. package/src/client/hooks/editor/theme.test.ts +206 -0
  169. package/src/client/hooks/editor/theme.ts +82 -0
  170. package/src/client/hooks/editor/typing-settings.test.ts +73 -0
  171. package/src/client/hooks/editor/typing-settings.ts +65 -0
  172. package/src/client/hooks/editor/use-close-guard.ts +98 -0
  173. package/src/client/hooks/editor/use-editor-drop-overlay.test.ts +159 -0
  174. package/src/client/hooks/editor/use-editor-drop.shell.test.ts +224 -0
  175. package/src/client/hooks/editor/use-editor-drop.test.ts +101 -0
  176. package/src/client/hooks/editor/use-editor-drop.ts +120 -77
  177. package/src/client/hooks/editor/use-editor-find.test.ts +2 -2
  178. package/src/client/hooks/editor/use-editor-find.ts +45 -10
  179. package/src/client/hooks/editor/use-editor-panel-keys.ts +152 -0
  180. package/src/client/hooks/editor/use-editor-tab-state.ts +71 -0
  181. package/src/client/hooks/editor/use-external-change-notice.ts +71 -0
  182. package/src/client/hooks/editor/use-external-change.test.ts +88 -0
  183. package/src/client/hooks/editor/use-external-change.ts +146 -0
  184. package/src/client/hooks/editor/use-file-editor.ts +83 -116
  185. package/src/client/hooks/editor/use-file-read.ts +16 -8
  186. package/src/client/hooks/editor/use-file-writes.ts +28 -3
  187. package/src/client/hooks/editor/use-mobile-editor-find.ts +69 -0
  188. package/src/client/hooks/editor/use-mobile-reveal.ts +53 -0
  189. package/src/client/hooks/editor/use-outline-view.test.ts +182 -0
  190. package/src/client/hooks/editor/use-outline-view.ts +94 -7
  191. package/src/client/hooks/editor/use-scroll-restore.test.ts +55 -2
  192. package/src/client/hooks/editor/use-scroll-restore.ts +124 -4
  193. package/src/client/hooks/editor/use-search-reveal-jump.ts +57 -0
  194. package/src/client/hooks/editor/use-search-reveal.ts +1 -1
  195. package/src/client/hooks/editor/use-split-editor.test.tsx +169 -0
  196. package/src/client/hooks/editor/use-split-editor.ts +91 -0
  197. package/src/client/hooks/editor/use-unload-guard.tsx +117 -0
  198. package/src/client/hooks/editor/use-write-conflict.test.ts +164 -0
  199. package/src/client/hooks/editor/use-write-conflict.ts +152 -0
  200. package/src/client/hooks/editor/wheel-zoom.test.ts +141 -0
  201. package/src/client/hooks/editor/wheel-zoom.ts +96 -0
  202. package/src/client/hooks/ui/drag-presence.test.ts +193 -0
  203. package/src/client/hooks/ui/drag-presence.ts +108 -0
  204. package/src/client/hooks/ui/settings-modal.test.ts +115 -0
  205. package/src/client/hooks/ui/settings-modal.ts +56 -0
  206. package/src/client/hooks/ui/updates/shell-download.test.ts +2 -0
  207. package/src/client/hooks/ui/updates/shell-download.ts +55 -14
  208. package/src/client/hooks/ui/updates/shell-offer.test.ts +26 -0
  209. package/src/client/hooks/ui/updates/shell-update.test.ts +140 -0
  210. package/src/client/hooks/ui/updates/shell-update.ts +119 -0
  211. package/src/client/hooks/workspace/diff-file.ts +29 -10
  212. package/src/client/hooks/workspace/diff-git-actions.ts +147 -0
  213. package/src/client/hooks/workspace/editor-view.ts +61 -0
  214. package/src/client/hooks/workspace/file-listing.ts +36 -24
  215. package/src/client/hooks/workspace/file-tabs.test.ts +152 -5
  216. package/src/client/hooks/workspace/file-tabs.ts +70 -11
  217. package/src/client/hooks/workspace/file-tree-edits.ts +103 -0
  218. package/src/client/hooks/workspace/navbar-session-actions.ts +72 -0
  219. package/src/client/hooks/workspace/worktree/index.ts +20 -5
  220. package/src/client/lib/desktop/bridge.ts +45 -0
  221. package/src/client/lib/desktop/dropped-paths.ts +83 -0
  222. package/src/client/lib/editor/tab-menu.test.ts +127 -0
  223. package/src/client/lib/editor/tab-menu.ts +127 -0
  224. package/src/client/lib/editor-dirty-tabs.test.ts +102 -0
  225. package/src/client/lib/editor-dirty-tabs.ts +103 -0
  226. package/src/client/lib/native/resume.test.ts +66 -0
  227. package/src/client/lib/native/resume.ts +42 -0
  228. package/src/client/lib/search-reveal.ts +1 -1
  229. package/src/client/main.tsx +13 -1
  230. package/src/client/tailwind.css +75 -8
  231. package/src/server/lib/auth/guard.test.ts +28 -0
  232. package/src/server/lib/auth/guard.ts +10 -0
  233. package/src/server/lib/bundler/css.test.ts +31 -0
  234. package/src/server/lib/fs/listing.test.ts +81 -16
  235. package/src/server/lib/fs/listing.ts +72 -5
  236. package/src/server/lib/fs/worktree/create.ts +2 -3
  237. package/src/server/lib/fs/worktree/list.ts +13 -0
  238. package/src/server/lib/fs/worktree/remove.ts +3 -3
  239. package/src/server/lib/fs/write-conflict.test.ts +68 -0
  240. package/src/server/lib/fs/write-conflict.ts +84 -0
  241. package/src/server/lib/lifecycle/claim-port.test.ts +156 -0
  242. package/src/server/lib/lifecycle/port-guard.test.ts +20 -164
  243. package/src/server/lib/lifecycle/port-guard.ts +39 -7
  244. package/src/server/lib/lifecycle/probe-health.test.ts +166 -0
  245. package/src/server/lib/lifecycle/probe.test.ts +77 -164
  246. package/src/server/lib/lifecycle/probe.ts +121 -13
  247. package/src/server/lib/omp/rpc/frame-fold-signals.test.ts +112 -0
  248. package/src/server/lib/omp/rpc/frame-fold.ts +10 -5
  249. package/src/server/lib/omp/session/sidebar-activity.server.test.ts +162 -0
  250. package/src/server/lib/omp/session/sidebar-activity.server.ts +70 -0
  251. package/src/server/lib/omp/session/telemetry/compute.ts +13 -1
  252. package/src/server/lib/omp/session/telemetry.test.ts +33 -0
  253. package/src/server/lib/realtime/signals.server.ts +10 -0
  254. package/src/server/lib/realtime/topics/catalog.server.ts +4 -1
  255. package/src/server/lib/realtime/topics.server.ts +16 -0
  256. package/src/server/lib/updates/shell-assets.ts +94 -3
  257. package/src/server/lib/updates/shell-cache.ts +105 -0
  258. package/src/server/lib/updates/shell-pages.test.ts +33 -2
  259. package/src/server/lib/updates/shell-pages.ts +17 -5
  260. package/src/server/lib/updates/shell-release-desktop.test.ts +166 -0
  261. package/src/server/lib/updates/shell-release.test.ts +10 -27
  262. package/src/server/lib/updates/shell-release.ts +107 -111
  263. package/src/server/routes/fs/action-save-as.test.ts +82 -0
  264. package/src/server/routes/fs/action.test.ts +82 -0
  265. package/src/server/routes/fs/action.ts +54 -1
  266. package/src/server/routes/fs/exists.ts +11 -1
  267. package/src/server/routes/fs/git-merge.test.ts +11 -1
  268. package/src/server/routes/fs/read.test.ts +24 -7
  269. package/src/server/routes/fs/read.ts +6 -1
  270. package/src/server/routes/fs/scope.test.ts +15 -10
  271. package/src/server/routes/fs/scope.ts +3 -14
  272. package/src/server/routes/updates/android.ts +6 -1
  273. package/src/server/routes/updates/desktop.ts +29 -7
  274. package/src/server/routes/updates/ios.ts +5 -1
  275. package/src/server/routes/worktrees/list.ts +11 -1
  276. package/src/server/routes/worktrees/routes.test.ts +17 -0
  277. package/src/shared/lib/chat/timeline/omp-callbacks.test.ts +36 -0
  278. package/src/shared/lib/chat/timeline/omp-callbacks.ts +18 -0
  279. package/src/shared/lib/chat/timeline/run-signals.test.ts +2 -0
  280. package/src/shared/lib/code/editor/comment-syntax.test.ts +37 -0
  281. package/src/shared/lib/code/editor/comment-syntax.ts +55 -0
  282. package/src/shared/lib/code/editor/find-replace.test.ts +134 -0
  283. package/src/shared/lib/code/editor/{find.ts → find-replace.ts} +23 -107
  284. package/src/shared/lib/code/editor/{find.test.ts → find-scan.test.ts} +20 -74
  285. package/src/shared/lib/code/editor/find-scan.ts +198 -0
  286. package/src/shared/lib/code/editor/find-selection.test.ts +56 -0
  287. package/src/shared/lib/code/editor/indent-guide-rule.test.ts +65 -0
  288. package/src/shared/lib/code/editor/indent-guide-rule.ts +47 -0
  289. package/src/shared/lib/code/editor/indent-rules.test.ts +219 -0
  290. package/src/shared/lib/code/editor/indent-rules.ts +198 -0
  291. package/src/shared/lib/code/editor/keymap.test.ts +23 -0
  292. package/src/shared/lib/code/editor/keymap.ts +43 -6
  293. package/src/shared/lib/code/editor/lines.test.ts +7 -55
  294. package/src/shared/lib/code/editor/lines.ts +8 -48
  295. package/src/shared/lib/code/editor/marks.test.ts +4 -5
  296. package/src/shared/lib/code/editor/marks.ts +13 -25
  297. package/src/shared/lib/code/editor/palette.test.ts +25 -2
  298. package/src/shared/lib/code/editor/palette.ts +10 -0
  299. package/src/shared/lib/code/editor/stream-modes.ts +225 -0
  300. package/src/shared/lib/code/editor/theme-loader.ts +97 -0
  301. package/src/shared/lib/code/editor/themes.generated.ts +156 -0
  302. package/src/shared/lib/code/editor/themes.test.ts +165 -0
  303. package/src/shared/lib/code/editor/themes.ts +165 -0
  304. package/src/shared/lib/code/highlight-memo.test.ts +103 -0
  305. package/src/shared/lib/code/highlight-memo.ts +149 -0
  306. package/src/shared/lib/code/highlighter-warmup.ts +112 -0
  307. package/src/shared/lib/code/highlighter.ts +3 -1
  308. package/src/shared/lib/code/idle.ts +37 -0
  309. package/src/shared/lib/code/outline/rows.test.ts +96 -0
  310. package/src/shared/lib/code/outline/rows.ts +94 -0
  311. package/src/shared/lib/code/syntax-highlight.test.ts +2 -80
  312. package/src/shared/lib/code/syntax-highlight.ts +2 -3
  313. package/src/shared/lib/fs/file-kind-classify.test.ts +25 -11
  314. package/src/shared/lib/fs/file-kind.ts +47 -13
  315. package/src/shared/lib/fs/file-tree.test.ts +41 -0
  316. package/src/shared/lib/fs/file-tree.ts +126 -34
  317. package/src/shared/lib/fs/file-url.test.ts +52 -0
  318. package/src/shared/lib/fs/file-url.ts +37 -0
  319. package/src/shared/lib/fs/folder-chain.test.ts +87 -0
  320. package/src/shared/lib/fs/folder-chain.ts +91 -0
  321. package/src/shared/lib/fs/fs-helpers.test.ts +4 -50
  322. package/src/shared/lib/fs/patch-sides.test.ts +114 -0
  323. package/src/shared/lib/fs/patch-sides.ts +139 -0
  324. package/src/shared/lib/realtime/connection.test.ts +5 -1
  325. package/src/shared/lib/realtime/connection.ts +25 -119
  326. package/src/shared/lib/realtime/frozen-recovery.test.ts +93 -0
  327. package/src/shared/lib/realtime/protocol.ts +16 -0
  328. package/src/shared/lib/realtime/resume.ts +223 -0
  329. package/src/shared/lib/realtime/state.ts +22 -0
  330. package/src/shared/lib/realtime/watchdog-wiring.test.ts +224 -0
  331. package/src/shared/lib/realtime/watchdog.test.ts +99 -0
  332. package/src/shared/lib/realtime/watchdog.ts +72 -0
  333. package/src/shared/lib/ui/toolbar-overflow.test.ts +83 -0
  334. package/src/shared/lib/ui/toolbar-overflow.ts +86 -0
  335. package/src/shared/lib/updates/shell-arch.ts +54 -0
  336. package/src/shared/lib/updates/shell-ua.ts +4 -4
  337. package/src/shared/lib/workspace/editor-view-mode.test.ts +70 -0
  338. package/src/shared/lib/workspace/editor-view-mode.ts +48 -0
  339. package/src/shared/lib/workspace/panel-widths.test.ts +30 -0
  340. package/src/shared/lib/workspace/panel-widths.ts +25 -5
  341. package/src/shared/lib/workspace/session-state/cache.ts +159 -0
  342. package/src/shared/lib/workspace/session-state/harness.test-util.ts +55 -0
  343. package/src/shared/lib/workspace/session-state/merge.ts +100 -0
  344. package/src/shared/lib/workspace/session-state/store-load.test.ts +206 -0
  345. package/src/shared/lib/workspace/session-state/store.test.ts +17 -139
  346. package/src/shared/lib/workspace/session-state/store.ts +92 -130
  347. package/src/shared/lib/workspace/split-editor.test.ts +104 -0
  348. package/src/shared/lib/workspace/split-editor.ts +129 -0
  349. package/src/shared/lib/workspace/workspace-panel-widths.ts +124 -0
  350. package/src/shared/types/realtime.ts +29 -0
  351. package/src/shared/types/settings/state.ts +10 -0
  352. package/src/test-support/file-explorer-disk.test-util.ts +30 -3
  353. package/src/test-support/loopback.ts +183 -0
  354. package/src/test-support/pristine-globals.ts +7 -0
  355. package/dist/client/static/js/index-gtbpewr7.css +0 -1
  356. package/src/client/components/common/code-editor/handler.test.ts +0 -274
  357. package/src/client/components/common/code-editor/handler.ts +0 -175
  358. package/src/client/components/common/code-editor/index.tsx +0 -314
  359. package/src/client/components/common/code-surface/measure.ts +0 -148
  360. package/src/client/components/workspace/chat-timeline/target-picker/index.test.tsx +0 -227
  361. package/src/client/components/workspace/chat-timeline/target-picker/index.tsx +0 -260
  362. package/src/client/components/workspace/diff-panel/SplitView.tsx +0 -209
  363. package/src/client/components/workspace/diff-panel/UnifiedView.tsx +0 -150
  364. package/src/client/hooks/editor/scroll-container.test.ts +0 -102
  365. package/src/client/hooks/editor/scroll-container.ts +0 -26
  366. package/src/client/hooks/editor/use-code-window.ts +0 -100
  367. package/src/client/hooks/editor/use-editor-history.test.ts +0 -216
  368. package/src/client/hooks/editor/use-editor-history.ts +0 -134
  369. package/src/client/hooks/editor/use-occurrences.test.ts +0 -236
  370. package/src/client/hooks/editor/use-occurrences.ts +0 -98
  371. package/src/shared/lib/code/editor/commands.test.ts +0 -155
  372. package/src/shared/lib/code/editor/commands.ts +0 -260
  373. package/src/shared/lib/code/editor/edits.test.ts +0 -100
  374. package/src/shared/lib/code/editor/edits.ts +0 -122
  375. package/src/shared/lib/code/editor/history.test.ts +0 -118
  376. package/src/shared/lib/code/editor/history.ts +0 -101
  377. package/src/shared/lib/code/editor/layers.test.ts +0 -77
  378. package/src/shared/lib/code/editor/layers.ts +0 -67
  379. package/src/shared/lib/code/editor/line-edits.test.ts +0 -131
  380. package/src/shared/lib/code/editor/line-edits.ts +0 -159
  381. package/src/shared/lib/code/editor/occurrences.test.ts +0 -117
  382. package/src/shared/lib/code/editor/occurrences.ts +0 -111
  383. package/src/shared/lib/code/editor/reset-css.test.ts +0 -35
  384. package/src/shared/lib/code/editor/reset-css.ts +0 -32
  385. package/src/shared/lib/code/editor/text-commands.test.ts +0 -178
  386. package/src/shared/lib/code/editor/text-commands.ts +0 -154
  387. package/src/shared/lib/code/lazy-window.test.ts +0 -161
  388. package/src/shared/lib/code/lazy-window.ts +0 -156
  389. package/src/shared/lib/code/windowed-highlight.ts +0 -114
  390. package/src/shared/lib/fs/diff-parser.test.ts +0 -116
  391. package/src/shared/lib/fs/diff-parser.ts +0 -213
@@ -0,0 +1,65 @@
1
+ /**
2
+ * @license
3
+ * SPDX-License-Identifier: Apache-2.0
4
+ */
5
+
6
+ /**
7
+ * `isSpawnArrival` / `isOwnSpawn` — the two questions a session-id change asks.
8
+ *
9
+ * Both are pure so every ordering can be stated directly. The orderings are the
10
+ * point: the browser is where they were found (three CI specs at once showed an
11
+ * answer on screen and then an empty timeline), but reproducing a child that
12
+ * answers before the URL flips is not something a browser spec can be asked to
13
+ * do on demand.
14
+ */
15
+
16
+ import { describe, expect, test } from 'bun:test';
17
+ import { isOwnSpawn, isSpawnArrival } from '@/client/hooks/chat/timeline/session-switch';
18
+
19
+ describe('isSpawnArrival', () => {
20
+ test('the id the send path recorded is an arrival, whatever the previous id was', () => {
21
+ // A chat opened from a WORKSPACE: no `?sessionId=` at all, so the previous
22
+ // id is null and the URL moves straight to the child's UUID. This is the
23
+ // shape that used to clear a finished turn.
24
+ expect(
25
+ isSpawnArrival({ sessionId: 'uuid-1', previousSessionId: null, adoptedSessionId: 'uuid-1' }),
26
+ ).toBe(true);
27
+ // A pending chat, mid-run or after it: same fact.
28
+ expect(
29
+ isSpawnArrival({ sessionId: 'uuid-1', previousSessionId: 'new-9', adoptedSessionId: 'uuid-1' }),
30
+ ).toBe(true);
31
+ });
32
+
33
+ test('`new-…` → UUID is still an arrival when the record was already consumed', () => {
34
+ // The pending store hands the adoption to the session-state provider once,
35
+ // so the URL's own shape is the only evidence left.
36
+ expect(
37
+ isSpawnArrival({ sessionId: 'uuid-1', previousSessionId: 'new-9', adoptedSessionId: null }),
38
+ ).toBe(true);
39
+ });
40
+
41
+ test('opening another session is not an arrival', () => {
42
+ expect(
43
+ isSpawnArrival({ sessionId: 'uuid-2', previousSessionId: 'uuid-1', adoptedSessionId: 'uuid-1' }),
44
+ ).toBe(false);
45
+ });
46
+
47
+ test('a null or unchanged id is not an arrival', () => {
48
+ expect(isSpawnArrival({ sessionId: null, previousSessionId: 'uuid-1', adoptedSessionId: null })).toBe(false);
49
+ expect(
50
+ isSpawnArrival({ sessionId: 'uuid-1', previousSessionId: 'uuid-1', adoptedSessionId: 'uuid-1' }),
51
+ ).toBe(true);
52
+ });
53
+ });
54
+
55
+ describe('isOwnSpawn', () => {
56
+ test('a pending id and the adopted UUID are both own spawns', () => {
57
+ expect(isOwnSpawn('new-9', null)).toBe(true);
58
+ expect(isOwnSpawn('uuid-1', 'uuid-1')).toBe(true);
59
+ });
60
+
61
+ test('a session this page did not spawn is not one', () => {
62
+ expect(isOwnSpawn('uuid-2', 'uuid-1')).toBe(false);
63
+ expect(isOwnSpawn(null, 'uuid-1')).toBe(false);
64
+ });
65
+ });
@@ -0,0 +1,63 @@
1
+ /**
2
+ * @license
3
+ * SPDX-License-Identifier: Apache-2.0
4
+ */
5
+
6
+ /**
7
+ * Which rows a session-switch keeps, and which a committed payload may replace.
8
+ *
9
+ * Split out of `session-load.ts` for the file-size ceiling, and it is one
10
+ * subject rather than an arbitrary cut: both functions answer "does this arrival
11
+ * belong to the session the timeline is already showing?".
12
+ *
13
+ * The distinction they encode was paid for twice, in opposite directions.
14
+ *
15
+ * - **A spawn's arrival is not a session switch.** The optimistic bubbles are
16
+ * the operator's own turn and the row the stream is filling; clearing them
17
+ * deleted a turn that had already rendered. Two shapes reach here and only one
18
+ * was ever recognised: `new-…` → UUID, and a chat opened from a WORKSPACE
19
+ * (`?folderId=` and no `?sessionId=`), whose previous id is `null` and whose
20
+ * URL moves straight to the child's UUID. The second was keyed on the
21
+ * generating flag, so a FAST child — the scripted one answers in milliseconds
22
+ * — finished before the URL flipped and the reset ran anyway. Measured in CI
23
+ * on three specs at once: the answer was on screen, then the timeline was
24
+ * empty. The id the send path recorded is the fact that survives either
25
+ * ordering.
26
+ * - **A committed payload is a lagging snapshot** while a run this page started
27
+ * owns the rows, and an own spawn's transcript may legitimately be empty (omp
28
+ * buffers its writes until the first assistant message settles). Either way it
29
+ * must not empty the timeline.
30
+ */
31
+
32
+ /** The ids a session-switch decision needs, all of them refs. */
33
+ export interface SessionSwitchFacts {
34
+ sessionId: string | null;
35
+ previousSessionId: string | null;
36
+ /** The id a spawn answered with, recorded by the send path. */
37
+ adoptedSessionId: string | null;
38
+ }
39
+
40
+ /**
41
+ * Whether this change is a spawn's arrival rather than the user opening another
42
+ * session — in which case the optimistic rows stay.
43
+ */
44
+ export function isSpawnArrival({ sessionId, previousSessionId, adoptedSessionId }: SessionSwitchFacts): boolean {
45
+ if (!sessionId) return false;
46
+ // The recorded id is checked FIRST and covers both orderings: it is written
47
+ // before the URL moves, so a child that answered mid-run and one that answered
48
+ // after the run ended are the same fact here.
49
+ if (adoptedSessionId === sessionId) return true;
50
+ // `new-…` → UUID. Kept as a fallback for a spawn whose record was already
51
+ // consumed (the pending store hands the adoption to the session-state
52
+ // provider once), where the URL's own shape is the only evidence left.
53
+ return previousSessionId?.startsWith('new-') === true && !sessionId.startsWith('new-');
54
+ }
55
+
56
+ /**
57
+ * Whether `sessionId` is one THIS PAGE spawned, so an empty committed payload
58
+ * means "not written yet" rather than "nothing happened".
59
+ */
60
+ export function isOwnSpawn(sessionId: string | null, adoptedSessionId: string | null): boolean {
61
+ if (!sessionId) return false;
62
+ return sessionId.startsWith('new-') || adoptedSessionId === sessionId;
63
+ }
@@ -0,0 +1,182 @@
1
+ /**
2
+ * @license
3
+ * SPDX-License-Identifier: Apache-2.0
4
+ */
5
+
6
+ /**
7
+ * The deferred-highlight hook, and the idle scheduler under it.
8
+ *
9
+ * The property that matters is the one the user feels: the FIRST render after a
10
+ * tap must not run the tokenizer. A card that appeared only after 220–300 ms of
11
+ * grammar work (measured at 4× CPU; 730–1484 ms at 20×) is the delay this
12
+ * exists to remove, and a hook that highlighted synchronously "sometimes" would
13
+ * pass a markup assertion and fail the point.
14
+ *
15
+ * So the scheduler is injectable here — the same seam the warm-up and the
16
+ * grammar loader use — and the assertions are about WHEN the compute ran, not
17
+ * only about what it produced. No wall-clock waits: the fallback path is driven
18
+ * by fake timers.
19
+ */
20
+
21
+ import { afterAll, afterEach, beforeAll, describe, expect, test, vi } from 'bun:test';
22
+ import { Window } from 'happy-dom';
23
+ import { h, render } from 'preact';
24
+ import { act } from 'preact/test-utils';
25
+
26
+ import { useDeferredHighlight } from '@/client/hooks/code/deferred-highlight';
27
+ import { scheduleIdle } from '@/shared/lib/code/idle';
28
+ import { clearHighlightMemo, highlightMemoSize } from '@/shared/lib/code/highlight-memo';
29
+ import { resetTokenizerWarmup, warmSyntaxTokenizers } from '@/shared/lib/code/highlighter-warmup';
30
+
31
+ const DOM_GLOBALS = ['window', 'document', 'navigator', 'Node', 'Element', 'HTMLElement', 'Event', 'MouseEvent'] as const;
32
+ const nativeGlobals: Partial<Record<(typeof DOM_GLOBALS)[number], unknown>> = {};
33
+ let container: HTMLElement;
34
+
35
+ beforeAll(() => {
36
+ const win = new Window({ url: 'http://localhost' });
37
+ const target = globalThis as unknown as Record<string, unknown>;
38
+ for (const key of DOM_GLOBALS) {
39
+ nativeGlobals[key] = target[key];
40
+ target[key] = (win as unknown as Record<string, unknown>)[key];
41
+ }
42
+ container = document.createElement('div');
43
+ document.body.appendChild(container);
44
+ });
45
+
46
+ afterAll(() => {
47
+ const target = globalThis as unknown as Record<string, unknown>;
48
+ for (const key of DOM_GLOBALS) {
49
+ if (nativeGlobals[key] === undefined) delete target[key];
50
+ else target[key] = nativeGlobals[key];
51
+ }
52
+ });
53
+
54
+ afterEach(() => {
55
+ clearHighlightMemo();
56
+ resetTokenizerWarmup();
57
+ });
58
+
59
+ describe('scheduleIdle', () => {
60
+ test('a runtime without requestIdleCallback still runs the work', () => {
61
+ const host = globalThis as unknown as Record<string, unknown>;
62
+ const saved = host.requestIdleCallback;
63
+ delete host.requestIdleCallback;
64
+ vi.useFakeTimers();
65
+ try {
66
+ let runs = 0;
67
+ scheduleIdle(() => { runs += 1; });
68
+ vi.advanceTimersByTime(1);
69
+ expect(runs).toBe(1);
70
+ } finally {
71
+ vi.useRealTimers();
72
+ if (saved !== undefined) host.requestIdleCallback = saved;
73
+ }
74
+ });
75
+
76
+ test('cancelling before the slice fires skips the work', () => {
77
+ const host = globalThis as unknown as Record<string, unknown>;
78
+ const saved = host.requestIdleCallback;
79
+ delete host.requestIdleCallback;
80
+ vi.useFakeTimers();
81
+ try {
82
+ let runs = 0;
83
+ const cancel = scheduleIdle(() => { runs += 1; });
84
+ cancel();
85
+ vi.advanceTimersByTime(1);
86
+ expect(runs).toBe(0);
87
+ } finally {
88
+ vi.useRealTimers();
89
+ if (saved !== undefined) host.requestIdleCallback = saved;
90
+ }
91
+ });
92
+ });
93
+
94
+ describe('warmSyntaxTokenizers', () => {
95
+ test('tokenizes one sample per language, one slice at a time', () => {
96
+ const calls: Array<{ language: string; code: string }> = [];
97
+ const queue: Array<() => void> = [];
98
+ warmSyntaxTokenizers({
99
+ languages: ['typescript', 'bash'],
100
+ ready: () => true,
101
+ highlight: (code, language) => calls.push({ language, code }),
102
+ schedule: (run) => {
103
+ queue.push(run);
104
+ return () => {};
105
+ },
106
+ });
107
+
108
+ // One slice is armed, not the whole set: a slow grammar must not become the
109
+ // long task this exists to prevent.
110
+ expect(queue).toHaveLength(1);
111
+ act(() => queue.shift()!());
112
+ expect(calls.map((c) => c.language)).toEqual(['typescript']);
113
+ expect(queue).toHaveLength(1);
114
+ act(() => queue.shift()!());
115
+ expect(calls.map((c) => c.language)).toEqual(['typescript', 'bash']);
116
+ });
117
+
118
+ test('is a no-op the second time, so a re-evaluated entry cannot re-warm', () => {
119
+ let calls = 0;
120
+ const options = {
121
+ languages: ['typescript'],
122
+ ready: () => true,
123
+ highlight: () => { calls += 1; },
124
+ schedule: (run: () => void) => { run(); return () => {}; },
125
+ };
126
+ warmSyntaxTokenizers(options);
127
+ warmSyntaxTokenizers(options);
128
+ expect(calls).toBe(1);
129
+ });
130
+
131
+ test('a grammar that has not landed is retried rather than skipped', () => {
132
+ const calls: string[] = [];
133
+ let ready = false;
134
+ const queue: Array<() => void> = [];
135
+ warmSyntaxTokenizers({
136
+ languages: ['typescript'],
137
+ ready: () => ready,
138
+ highlight: (_code, language) => calls.push(language),
139
+ schedule: (run) => {
140
+ queue.push(run);
141
+ return () => {};
142
+ },
143
+ });
144
+
145
+ act(() => queue.shift()!());
146
+ expect(calls).toEqual([]);
147
+ ready = true;
148
+ act(() => queue.shift()!());
149
+ expect(calls).toEqual(['typescript']);
150
+ });
151
+ });
152
+
153
+ describe('the deferred render', () => {
154
+ test('draws the escaped source without tokenizing on the mounting tick', async () => {
155
+ let renders = 0;
156
+ function Card({ code }: { code: string }) {
157
+ const html = useDeferredHighlight(code, 'typescript');
158
+ renders += 1;
159
+ return h('pre', { dangerouslySetInnerHTML: { __html: html } });
160
+ }
161
+
162
+ await act(async () => {
163
+ render(h(Card, { code: 'const value = 1;' }), container);
164
+ });
165
+
166
+ // Nothing has been tokenized on this tick — the tap's own task is clean.
167
+ expect(highlightMemoSize()).toBe(0);
168
+ expect(renders).toBeGreaterThan(0);
169
+ // What it DID draw is the escaped source, not an empty box.
170
+ expect(container.textContent).toContain('const value = 1;');
171
+ });
172
+
173
+ test('empty input renders nothing and caches nothing', async () => {
174
+ function Card() {
175
+ return h('pre', { dangerouslySetInnerHTML: { __html: useDeferredHighlight('', 'typescript') } });
176
+ }
177
+ await act(async () => {
178
+ render(h(Card, {}), container);
179
+ });
180
+ expect(highlightMemoSize()).toBe(0);
181
+ });
182
+ });
@@ -0,0 +1,129 @@
1
+ /**
2
+ * @license
3
+ * SPDX-License-Identifier: Apache-2.0
4
+ */
5
+
6
+ /**
7
+ * Syntax-highlighted markup that never blocks the interaction that asked for it.
8
+ *
9
+ * A tool card renders its code the moment it is expanded, and the tokenizer used
10
+ * to run inside that render: measured on a throttled phone (4× CPU), a `read`
11
+ * card's expand was a 220–300 ms long task of which ~75% was the Shiki grammar
12
+ * engine, and at 20× the same card blocked for 730–1.484 ms. The card was on
13
+ * screen the whole time — it just could not paint until the last line had been
14
+ * tokenized.
15
+ *
16
+ * So the first render draws the text, escaped and correct, and the tokenized
17
+ * markup replaces it once the main thread is free (`scheduleIdle`). The two
18
+ * carry the same characters, so the swap costs colour and no layout.
19
+ *
20
+ * Three properties make that honest:
21
+ *
22
+ * - **A cached block renders highlighted on the FIRST paint.** `highlight-memo`
23
+ * is checked during render, so reopening a card the reader already opened —
24
+ * the common case while paging a transcript — has no plain-text frame at all.
25
+ * - **A stale block is never shown.** The value is tagged with the input it was
26
+ * computed from; a filter keystroke in the search panel therefore shows the
27
+ * new text, never the previous query's markup.
28
+ * - **Nothing is computed for empty input.** Call sites that gate a branch pass
29
+ * `''`, which is how `Edit` stops tokenizing the two panels it is not drawing.
30
+ */
31
+
32
+ import { useEffect, useMemo, useState } from 'preact/hooks';
33
+ import { escapeCode } from '@/shared/lib/code/highlighter';
34
+ import {
35
+ cachedHighlightBlock,
36
+ cachedHighlightBlockLines,
37
+ highlightBlock,
38
+ highlightBlockLines,
39
+ } from '@/shared/lib/code/highlight-memo';
40
+ import { scheduleIdle } from '@/shared/lib/code/idle';
41
+ import { useSyntaxReady } from '@/client/hooks/ui/syntax-ready';
42
+
43
+ interface Deferred<T> {
44
+ /** Identity of the input; a value computed for another input is not shown. */
45
+ key: object;
46
+ hasContent: boolean;
47
+ cached: T | undefined;
48
+ plain: T;
49
+ compute: () => T;
50
+ }
51
+
52
+ function useDeferred<T>(spec: Deferred<T>): T {
53
+ // A grammar arriving is what turns a plain fallback into a real highlight, so
54
+ // the effect re-runs on it even though the input did not move.
55
+ const syntaxReady = useSyntaxReady();
56
+ const [state, setState] = useState<{ key: object; value: T }>(() => ({
57
+ key: spec.key,
58
+ value: spec.cached ?? spec.plain,
59
+ }));
60
+
61
+ /** Adopt a value only when it is a change, so a cached block does not cost an
62
+ * extra render on every mount. */
63
+ const adopt = (key: object, value: T): void => {
64
+ setState((previous) => (previous.key === key && previous.value === value ? previous : { key, value }));
65
+ };
66
+
67
+ useEffect(() => {
68
+ if (!spec.hasContent) {
69
+ adopt(spec.key, spec.plain);
70
+ return;
71
+ }
72
+ if (spec.cached !== undefined) {
73
+ adopt(spec.key, spec.cached);
74
+ return;
75
+ }
76
+ let cancelled = false;
77
+ const cancel = scheduleIdle(() => {
78
+ if (cancelled) return;
79
+ let value: T;
80
+ try {
81
+ value = spec.compute();
82
+ } catch {
83
+ // A grammar that cannot tokenize this input leaves the escaped text,
84
+ // which is what the first paint already drew.
85
+ value = spec.plain;
86
+ }
87
+ if (!cancelled) adopt(spec.key, value);
88
+ });
89
+ return () => {
90
+ cancelled = true;
91
+ cancel();
92
+ };
93
+ // `spec` is rebuilt every render; its KEY (the input) and the grammar's
94
+ // readiness are what decide the work.
95
+ // eslint-disable-next-line react-hooks/exhaustive-deps
96
+ }, [spec.key, syntaxReady]);
97
+
98
+ if (state.key === spec.key) return state.value;
99
+ return spec.cached ?? spec.plain;
100
+ }
101
+
102
+ /** Tokenized markup for one block, deferred off the render that asked for it. */
103
+ export function useDeferredHighlight(code: string, language: string): string {
104
+ const key = useMemo(() => ({ code, language }), [code, language]);
105
+ const plain = useMemo(() => escapeCode(code), [code]);
106
+ return useDeferred<string>({
107
+ key,
108
+ hasContent: Boolean(code),
109
+ cached: code ? cachedHighlightBlock(code, language) : undefined,
110
+ plain,
111
+ compute: () => highlightBlock(code, language),
112
+ });
113
+ }
114
+
115
+ /** Tokenized markup per line, deferred the same way. */
116
+ export function useDeferredHighlightLines(code: string, language: string): string[] {
117
+ const key = useMemo(() => ({ code, language }), [code, language]);
118
+ const plain = useMemo(
119
+ () => (code ? code.split('\n').map(escapeCode) : []),
120
+ [code],
121
+ );
122
+ return useDeferred<string[]>({
123
+ key,
124
+ hasContent: Boolean(code),
125
+ cached: code ? cachedHighlightBlockLines(code, language) : undefined,
126
+ plain,
127
+ compute: () => highlightBlockLines(code, language),
128
+ });
129
+ }
@@ -0,0 +1,58 @@
1
+ /**
2
+ * @license
3
+ * SPDX-License-Identifier: Apache-2.0
4
+ */
5
+
6
+ /**
7
+ * The caret readout's arithmetic.
8
+ *
9
+ * Small, and every branch is a number the user reads: `Ln 1, Col 1` at the start of
10
+ * the file, a column that counts a tab as one character (which is what every editor's
11
+ * `Col` shows), and a `null` before the surface has reported anything — a readout
12
+ * that printed `Ln 0, Col 0` would look like a position in an empty file.
13
+ */
14
+
15
+ import { describe, expect, test } from 'bun:test';
16
+ import { EditorSelection, EditorState } from '@codemirror/state';
17
+
18
+ import { caretPositionOf, sameCaret } from '@/client/hooks/editor/caret-position';
19
+
20
+ function stateAt(doc: string, anchor: number): EditorState {
21
+ return EditorState.create({ doc, selection: EditorSelection.single(anchor) });
22
+ }
23
+
24
+ describe('caretPositionOf', () => {
25
+ test('the start of the file is line 1, column 1', () => {
26
+ expect(caretPositionOf(stateAt('abc\ndef', 0))).toEqual({ line: 1, column: 1 });
27
+ });
28
+
29
+ test('a position mid-line counts characters from the line start', () => {
30
+ expect(caretPositionOf(stateAt('abc\ndef', 6))).toEqual({ line: 2, column: 3 });
31
+ });
32
+
33
+ test('the very end of a line is its own column, not the next line', () => {
34
+ expect(caretPositionOf(stateAt('abc\ndef', 3))).toEqual({ line: 1, column: 4 });
35
+ });
36
+
37
+ test('a tab counts as ONE character, which is what Col shows', () => {
38
+ expect(caretPositionOf(stateAt('\tabc', 2))).toEqual({ line: 1, column: 3 });
39
+ });
40
+
41
+ test('the last line of a file with a trailing newline is an empty line 2', () => {
42
+ expect(caretPositionOf(stateAt('a\n', 2))).toEqual({ line: 2, column: 1 });
43
+ });
44
+ });
45
+
46
+ describe('sameCaret', () => {
47
+ test('compares the two numbers, not the object identity', () => {
48
+ expect(sameCaret({ line: 1, column: 2 }, { line: 1, column: 2 })).toBe(true);
49
+ expect(sameCaret({ line: 1, column: 2 }, { line: 1, column: 3 })).toBe(false);
50
+ expect(sameCaret({ line: 1, column: 2 }, { line: 2, column: 2 })).toBe(false);
51
+ });
52
+
53
+ test('two nulls are the same, and null against a position is not', () => {
54
+ expect(sameCaret(null, null)).toBe(true);
55
+ expect(sameCaret(null, { line: 1, column: 1 })).toBe(false);
56
+ expect(sameCaret({ line: 1, column: 1 }, null)).toBe(false);
57
+ });
58
+ });
@@ -0,0 +1,48 @@
1
+ /**
2
+ * @license
3
+ * SPDX-License-Identifier: Apache-2.0
4
+ */
5
+
6
+ /**
7
+ * The caret's position, in the units a status bar prints.
8
+ *
9
+ * The phone has had a status strip since the editor was rebuilt; the desktop pane
10
+ * had nothing, so the only way to know where the caret was is to count lines.
11
+ *
12
+ * ## Why this is computed from a `State` and not read from the DOM
13
+ *
14
+ * The surface's update listener writes `data-line` and `data-selection` on the
15
+ * content element, and that attribute pair is documented as belonging to the e2e
16
+ * layer — "nothing in the app reads them". A status bar built on it would make an
17
+ * app feature depend on a test fixture. The surface therefore reports the caret
18
+ * through its own prop, from the same listener, and this module is the arithmetic.
19
+ *
20
+ * ## Column is 1-based and counts CHARACTERS, not display columns
21
+ *
22
+ * A tab counts as one, which is what an editor's "Col" shows and what the user's own
23
+ * selection arithmetic produces. Counting display columns would need the tab size
24
+ * and the font, and would disagree with the number under their cursor.
25
+ */
26
+
27
+ import type { EditorState } from '@codemirror/state';
28
+
29
+ /** Where the caret is, in the units the readout prints. */
30
+ export interface CaretPosition {
31
+ /** 1-based line number. */
32
+ line: number;
33
+ /** 1-based character offset within the line. */
34
+ column: number;
35
+ }
36
+
37
+ /** The caret's position in `state`. */
38
+ export function caretPositionOf(state: EditorState): CaretPosition {
39
+ const head = state.selection.main.head;
40
+ const line = state.doc.lineAt(head);
41
+ return { line: line.number, column: head - line.from + 1 };
42
+ }
43
+
44
+ /** Whether two positions print the same thing. */
45
+ export function sameCaret(a: CaretPosition | null, b: CaretPosition | null): boolean {
46
+ if (a === null || b === null) return a === b;
47
+ return a.line === b.line && a.column === b.column;
48
+ }