@fairyhunter13/opentui-core 0.1.112 → 0.1.114

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 (591) hide show
  1. package/dev/keypress-debug-renderer.ts +148 -0
  2. package/dev/keypress-debug.ts +43 -0
  3. package/dev/print-env-vars.ts +32 -0
  4. package/dev/test-tmux-graphics-334.sh +68 -0
  5. package/dev/thai-debug-test.ts +68 -0
  6. package/docs/development.md +144 -0
  7. package/package.json +63 -51
  8. package/scripts/build.ts +400 -0
  9. package/scripts/publish.ts +60 -0
  10. package/src/3d/SpriteResourceManager.ts +286 -0
  11. package/src/3d/SpriteUtils.ts +70 -0
  12. package/src/3d/TextureUtils.ts +196 -0
  13. package/src/3d/ThreeRenderable.ts +197 -0
  14. package/src/3d/WGPURenderer.ts +294 -0
  15. package/src/3d/animation/ExplodingSpriteEffect.ts +513 -0
  16. package/src/3d/animation/PhysicsExplodingSpriteEffect.ts +429 -0
  17. package/src/3d/animation/SpriteAnimator.ts +633 -0
  18. package/src/3d/animation/SpriteParticleGenerator.ts +435 -0
  19. package/src/3d/canvas.ts +464 -0
  20. package/src/3d/index.ts +12 -0
  21. package/src/3d/physics/PlanckPhysicsAdapter.ts +72 -0
  22. package/src/3d/physics/RapierPhysicsAdapter.ts +66 -0
  23. package/src/3d/physics/physics-interface.ts +31 -0
  24. package/src/3d/shaders/supersampling.wgsl +201 -0
  25. package/src/3d.ts +3 -0
  26. package/src/NativeSpanFeed.ts +300 -0
  27. package/src/Renderable.ts +1704 -0
  28. package/src/__snapshots__/buffer.test.ts.snap +28 -0
  29. package/src/animation/Timeline.test.ts +2709 -0
  30. package/src/animation/Timeline.ts +598 -0
  31. package/src/ansi.ts +18 -0
  32. package/src/benchmark/attenuation-benchmark.ts +81 -0
  33. package/src/benchmark/colormatrix-benchmark.ts +128 -0
  34. package/src/benchmark/gain-benchmark.ts +80 -0
  35. package/src/benchmark/latest-all-bench-run.json +707 -0
  36. package/src/benchmark/latest-async-bench-run.json +336 -0
  37. package/src/benchmark/latest-default-bench-run.json +657 -0
  38. package/src/benchmark/latest-large-bench-run.json +707 -0
  39. package/src/benchmark/latest-quick-bench-run.json +207 -0
  40. package/src/benchmark/markdown-benchmark.ts +1796 -0
  41. package/src/benchmark/native-span-feed-async-benchmark.ts +355 -0
  42. package/src/benchmark/native-span-feed-benchmark.md +56 -0
  43. package/src/benchmark/native-span-feed-benchmark.ts +596 -0
  44. package/src/benchmark/native-span-feed-compare.ts +280 -0
  45. package/src/benchmark/renderer-benchmark.ts +754 -0
  46. package/src/benchmark/text-table-benchmark.ts +948 -0
  47. package/src/buffer.test.ts +291 -0
  48. package/src/buffer.ts +554 -0
  49. package/src/console.test.ts +612 -0
  50. package/src/console.ts +1254 -0
  51. package/src/edit-buffer.test.ts +1769 -0
  52. package/src/edit-buffer.ts +411 -0
  53. package/src/editor-view.test.ts +1032 -0
  54. package/src/editor-view.ts +284 -0
  55. package/src/examples/ascii-font-selection-demo.ts +245 -0
  56. package/src/examples/assets/Water_2_M_Normal.jpg +0 -0
  57. package/src/examples/assets/concrete.png +0 -0
  58. package/src/examples/assets/crate.png +0 -0
  59. package/src/examples/assets/crate_emissive.png +0 -0
  60. package/src/examples/assets/forrest_background.png +0 -0
  61. package/src/examples/assets/hast-example.json +1018 -0
  62. package/src/examples/assets/heart.png +0 -0
  63. package/src/examples/assets/main_char_heavy_attack.png +0 -0
  64. package/src/examples/assets/main_char_idle.png +0 -0
  65. package/src/examples/assets/main_char_jump_end.png +0 -0
  66. package/src/examples/assets/main_char_jump_landing.png +0 -0
  67. package/src/examples/assets/main_char_jump_start.png +0 -0
  68. package/src/examples/assets/main_char_run_loop.png +0 -0
  69. package/src/examples/assets/roughness_map.jpg +0 -0
  70. package/src/examples/build.ts +115 -0
  71. package/src/examples/code-demo.ts +924 -0
  72. package/src/examples/console-demo.ts +358 -0
  73. package/src/examples/core-plugin-slots-demo.ts +759 -0
  74. package/src/examples/diff-demo.ts +701 -0
  75. package/src/examples/draggable-three-demo.ts +259 -0
  76. package/src/examples/editor-demo.ts +322 -0
  77. package/src/examples/extmarks-demo.ts +196 -0
  78. package/src/examples/focus-restore-demo.ts +310 -0
  79. package/src/examples/fonts.ts +245 -0
  80. package/src/examples/fractal-shader-demo.ts +268 -0
  81. package/src/examples/framebuffer-demo.ts +674 -0
  82. package/src/examples/full-unicode-demo.ts +241 -0
  83. package/src/examples/golden-star-demo.ts +933 -0
  84. package/src/examples/grayscale-buffer-demo.ts +249 -0
  85. package/src/examples/hast-syntax-highlighting-demo.ts +129 -0
  86. package/src/examples/index.ts +926 -0
  87. package/src/examples/input-demo.ts +377 -0
  88. package/src/examples/input-select-layout-demo.ts +425 -0
  89. package/src/examples/install.sh +143 -0
  90. package/src/examples/keypress-debug-demo.ts +452 -0
  91. package/src/examples/lib/HexList.ts +122 -0
  92. package/src/examples/lib/PaletteGrid.ts +125 -0
  93. package/src/examples/lib/standalone-keys.ts +25 -0
  94. package/src/examples/lib/tab-controller.ts +243 -0
  95. package/src/examples/lights-phong-demo.ts +290 -0
  96. package/src/examples/link-demo.ts +220 -0
  97. package/src/examples/live-state-demo.ts +480 -0
  98. package/src/examples/markdown-demo.ts +725 -0
  99. package/src/examples/mouse-interaction-demo.ts +428 -0
  100. package/src/examples/nested-zindex-demo.ts +357 -0
  101. package/src/examples/opacity-example.ts +235 -0
  102. package/src/examples/opentui-demo.ts +1057 -0
  103. package/src/examples/physx-planck-2d-demo.ts +623 -0
  104. package/src/examples/physx-rapier-2d-demo.ts +655 -0
  105. package/src/examples/relative-positioning-demo.ts +323 -0
  106. package/src/examples/scroll-example.ts +214 -0
  107. package/src/examples/scrollbox-mouse-test.ts +112 -0
  108. package/src/examples/scrollbox-overlay-hit-test.ts +206 -0
  109. package/src/examples/select-demo.ts +237 -0
  110. package/src/examples/shader-cube-demo.ts +1015 -0
  111. package/src/examples/simple-layout-example.ts +591 -0
  112. package/src/examples/slider-demo.ts +617 -0
  113. package/src/examples/split-mode-demo.ts +453 -0
  114. package/src/examples/sprite-animation-demo.ts +443 -0
  115. package/src/examples/sprite-particle-generator-demo.ts +486 -0
  116. package/src/examples/static-sprite-demo.ts +193 -0
  117. package/src/examples/sticky-scroll-example.ts +308 -0
  118. package/src/examples/styled-text-demo.ts +282 -0
  119. package/src/examples/tab-select-demo.ts +219 -0
  120. package/src/examples/terminal-title.ts +29 -0
  121. package/src/examples/terminal.ts +305 -0
  122. package/src/examples/text-node-demo.ts +416 -0
  123. package/src/examples/text-selection-demo.ts +377 -0
  124. package/src/examples/text-table-demo.ts +503 -0
  125. package/src/examples/text-truncation-demo.ts +481 -0
  126. package/src/examples/text-wrap.ts +757 -0
  127. package/src/examples/texture-loading-demo.ts +259 -0
  128. package/src/examples/timeline-example.ts +670 -0
  129. package/src/examples/transparency-demo.ts +400 -0
  130. package/src/examples/vnode-composition-demo.ts +404 -0
  131. package/src/examples/wide-grapheme-overlay-demo.ts +280 -0
  132. package/src/index.ts +24 -0
  133. package/src/lib/KeyHandler.integration.test.ts +292 -0
  134. package/src/lib/KeyHandler.stopPropagation.test.ts +289 -0
  135. package/src/lib/KeyHandler.test.ts +662 -0
  136. package/src/lib/KeyHandler.ts +222 -0
  137. package/src/lib/RGBA.test.ts +984 -0
  138. package/src/lib/RGBA.ts +204 -0
  139. package/src/lib/ascii.font.ts +330 -0
  140. package/src/lib/border.test.ts +83 -0
  141. package/src/lib/border.ts +170 -0
  142. package/src/lib/bunfs.test.ts +27 -0
  143. package/src/lib/bunfs.ts +18 -0
  144. package/src/lib/clipboard.test.ts +41 -0
  145. package/src/lib/clipboard.ts +47 -0
  146. package/src/lib/clock.ts +35 -0
  147. package/src/lib/data-paths.test.ts +133 -0
  148. package/src/lib/data-paths.ts +109 -0
  149. package/src/lib/debounce.ts +106 -0
  150. package/src/lib/detect-links.test.ts +98 -0
  151. package/src/lib/detect-links.ts +56 -0
  152. package/src/lib/env.test.ts +228 -0
  153. package/src/lib/env.ts +209 -0
  154. package/src/lib/extmarks-history.ts +51 -0
  155. package/src/lib/extmarks-multiwidth.test.ts +322 -0
  156. package/src/lib/extmarks.test.ts +3457 -0
  157. package/src/lib/extmarks.ts +843 -0
  158. package/src/lib/fonts/block.json +405 -0
  159. package/src/lib/fonts/grid.json +265 -0
  160. package/src/lib/fonts/huge.json +741 -0
  161. package/src/lib/fonts/pallet.json +314 -0
  162. package/src/lib/fonts/shade.json +591 -0
  163. package/src/lib/fonts/slick.json +321 -0
  164. package/src/lib/fonts/tiny.json +69 -0
  165. package/src/lib/hast-styled-text.ts +59 -0
  166. package/src/lib/index.ts +21 -0
  167. package/src/lib/keymapping.test.ts +317 -0
  168. package/src/lib/keymapping.ts +115 -0
  169. package/src/lib/objects-in-viewport.test.ts +787 -0
  170. package/src/lib/objects-in-viewport.ts +153 -0
  171. package/src/lib/output.capture.ts +58 -0
  172. package/src/lib/parse.keypress-kitty.protocol.test.ts +340 -0
  173. package/src/lib/parse.keypress-kitty.test.ts +663 -0
  174. package/src/lib/parse.keypress-kitty.ts +439 -0
  175. package/src/lib/parse.keypress.test.ts +1849 -0
  176. package/src/lib/parse.keypress.ts +397 -0
  177. package/src/lib/parse.mouse.test.ts +552 -0
  178. package/src/lib/parse.mouse.ts +232 -0
  179. package/src/lib/paste.ts +16 -0
  180. package/src/lib/queue.ts +65 -0
  181. package/src/lib/renderable.validations.test.ts +87 -0
  182. package/src/lib/renderable.validations.ts +83 -0
  183. package/src/lib/scroll-acceleration.ts +98 -0
  184. package/src/lib/selection.ts +240 -0
  185. package/src/lib/singleton.ts +28 -0
  186. package/src/lib/stdin-parser.test.ts +2290 -0
  187. package/src/lib/stdin-parser.ts +1810 -0
  188. package/src/lib/styled-text.ts +178 -0
  189. package/src/lib/terminal-capability-detection.test.ts +202 -0
  190. package/src/lib/terminal-capability-detection.ts +79 -0
  191. package/src/lib/terminal-palette.test.ts +878 -0
  192. package/src/lib/terminal-palette.ts +383 -0
  193. package/src/lib/tree-sitter/assets/README.md +118 -0
  194. package/src/lib/tree-sitter/assets/update.ts +334 -0
  195. package/src/lib/tree-sitter/assets.d.ts +9 -0
  196. package/src/lib/tree-sitter/cache.test.ts +273 -0
  197. package/src/lib/tree-sitter/client.test.ts +1165 -0
  198. package/src/lib/tree-sitter/client.ts +607 -0
  199. package/src/lib/tree-sitter/default-parsers.ts +86 -0
  200. package/src/lib/tree-sitter/download-utils.ts +148 -0
  201. package/src/lib/tree-sitter/index.ts +28 -0
  202. package/src/lib/tree-sitter/parser.worker.ts +1042 -0
  203. package/src/lib/tree-sitter/parsers-config.ts +81 -0
  204. package/src/lib/tree-sitter/resolve-ft.test.ts +55 -0
  205. package/src/lib/tree-sitter/resolve-ft.ts +189 -0
  206. package/src/lib/tree-sitter/types.ts +82 -0
  207. package/src/lib/tree-sitter-styled-text.test.ts +1253 -0
  208. package/src/lib/tree-sitter-styled-text.ts +306 -0
  209. package/src/lib/validate-dir-name.ts +55 -0
  210. package/src/lib/yoga.options.test.ts +628 -0
  211. package/src/lib/yoga.options.ts +346 -0
  212. package/src/plugins/core-slot.ts +579 -0
  213. package/src/plugins/registry.ts +402 -0
  214. package/src/plugins/types.ts +46 -0
  215. package/src/post/effects.ts +930 -0
  216. package/src/post/filters.ts +489 -0
  217. package/src/post/matrices.ts +288 -0
  218. package/src/renderables/ASCIIFont.ts +219 -0
  219. package/src/renderables/Box.test.ts +205 -0
  220. package/src/renderables/Box.ts +326 -0
  221. package/src/renderables/Code.test.ts +2062 -0
  222. package/src/renderables/Code.ts +357 -0
  223. package/src/renderables/Diff.regression.test.ts +226 -0
  224. package/src/renderables/Diff.test.ts +3101 -0
  225. package/src/renderables/Diff.ts +1211 -0
  226. package/src/renderables/EditBufferRenderable.test.ts +288 -0
  227. package/src/renderables/EditBufferRenderable.ts +1166 -0
  228. package/src/renderables/FrameBuffer.ts +47 -0
  229. package/src/renderables/Input.test.ts +1228 -0
  230. package/src/renderables/Input.ts +247 -0
  231. package/src/renderables/LineNumberRenderable.ts +724 -0
  232. package/src/renderables/Markdown.ts +1393 -0
  233. package/src/renderables/ScrollBar.ts +422 -0
  234. package/src/renderables/ScrollBox.ts +883 -0
  235. package/src/renderables/Select.test.ts +1033 -0
  236. package/src/renderables/Select.ts +524 -0
  237. package/src/renderables/Slider.test.ts +456 -0
  238. package/src/renderables/Slider.ts +342 -0
  239. package/src/renderables/TabSelect.test.ts +197 -0
  240. package/src/renderables/TabSelect.ts +455 -0
  241. package/src/renderables/Text.selection-buffer.test.ts +123 -0
  242. package/src/renderables/Text.test.ts +2660 -0
  243. package/src/renderables/Text.ts +147 -0
  244. package/src/renderables/TextBufferRenderable.ts +518 -0
  245. package/src/renderables/TextNode.test.ts +1058 -0
  246. package/src/renderables/TextNode.ts +325 -0
  247. package/src/renderables/TextTable.test.ts +1421 -0
  248. package/src/renderables/TextTable.ts +1344 -0
  249. package/src/renderables/Textarea.ts +430 -0
  250. package/src/renderables/TimeToFirstDraw.ts +89 -0
  251. package/src/renderables/__snapshots__/Code.test.ts.snap +13 -0
  252. package/src/renderables/__snapshots__/Diff.test.ts.snap +785 -0
  253. package/src/renderables/__snapshots__/Text.test.ts.snap +421 -0
  254. package/src/renderables/__snapshots__/TextTable.test.ts.snap +215 -0
  255. package/src/renderables/__tests__/LineNumberRenderable.scrollbox-simple.test.ts +144 -0
  256. package/src/renderables/__tests__/LineNumberRenderable.scrollbox.test.ts +816 -0
  257. package/src/renderables/__tests__/LineNumberRenderable.test.ts +1865 -0
  258. package/src/renderables/__tests__/LineNumberRenderable.wrapping.test.ts +85 -0
  259. package/src/renderables/__tests__/Markdown.code-colors.test.ts +242 -0
  260. package/src/renderables/__tests__/Markdown.test.ts +2518 -0
  261. package/src/renderables/__tests__/MultiRenderable.selection.test.ts +87 -0
  262. package/src/renderables/__tests__/Textarea.buffer.test.ts +682 -0
  263. package/src/renderables/__tests__/Textarea.destroyed-events.test.ts +675 -0
  264. package/src/renderables/__tests__/Textarea.editing.test.ts +2041 -0
  265. package/src/renderables/__tests__/Textarea.error-handling.test.ts +35 -0
  266. package/src/renderables/__tests__/Textarea.events.test.ts +738 -0
  267. package/src/renderables/__tests__/Textarea.highlights.test.ts +590 -0
  268. package/src/renderables/__tests__/Textarea.keybinding.test.ts +3149 -0
  269. package/src/renderables/__tests__/Textarea.paste.test.ts +357 -0
  270. package/src/renderables/__tests__/Textarea.rendering.test.ts +1866 -0
  271. package/src/renderables/__tests__/Textarea.scroll.test.ts +733 -0
  272. package/src/renderables/__tests__/Textarea.selection.test.ts +1590 -0
  273. package/src/renderables/__tests__/Textarea.stress.test.ts +670 -0
  274. package/src/renderables/__tests__/Textarea.undo-redo.test.ts +383 -0
  275. package/src/renderables/__tests__/Textarea.visual-lines.test.ts +310 -0
  276. package/src/renderables/__tests__/__snapshots__/LineNumberRenderable.code.test.ts.snap +221 -0
  277. package/src/renderables/__tests__/__snapshots__/LineNumberRenderable.scrollbox-simple.test.ts.snap +89 -0
  278. package/src/renderables/__tests__/__snapshots__/LineNumberRenderable.scrollbox.test.ts.snap +457 -0
  279. package/src/renderables/__tests__/__snapshots__/LineNumberRenderable.test.ts.snap +158 -0
  280. package/src/renderables/__tests__/__snapshots__/Textarea.rendering.test.ts.snap +387 -0
  281. package/src/renderables/__tests__/markdown-parser.test.ts +217 -0
  282. package/src/renderables/__tests__/renderable-test-utils.ts +60 -0
  283. package/src/renderables/composition/README.md +8 -0
  284. package/src/renderables/composition/VRenderable.ts +32 -0
  285. package/src/renderables/composition/constructs.ts +127 -0
  286. package/src/renderables/composition/vnode.ts +289 -0
  287. package/src/renderables/index.ts +23 -0
  288. package/src/renderables/markdown-parser.ts +66 -0
  289. package/src/renderer.ts +2681 -0
  290. package/src/runtime-plugin-support.ts +39 -0
  291. package/src/runtime-plugin.ts +615 -0
  292. package/src/syntax-style.test.ts +841 -0
  293. package/src/syntax-style.ts +257 -0
  294. package/src/testing/README.md +210 -0
  295. package/src/testing/capture-spans.test.ts +194 -0
  296. package/src/testing/integration.test.ts +276 -0
  297. package/src/testing/manual-clock.ts +117 -0
  298. package/src/testing/mock-keys.test.ts +1378 -0
  299. package/src/testing/mock-keys.ts +457 -0
  300. package/src/testing/mock-mouse.test.ts +218 -0
  301. package/src/testing/mock-mouse.ts +247 -0
  302. package/src/testing/mock-tree-sitter-client.ts +73 -0
  303. package/src/testing/spy.ts +13 -0
  304. package/src/testing/test-recorder.test.ts +415 -0
  305. package/src/testing/test-recorder.ts +145 -0
  306. package/src/testing/test-renderer.ts +132 -0
  307. package/src/testing.ts +7 -0
  308. package/src/tests/__snapshots__/absolute-positioning.snapshot.test.ts.snap +481 -0
  309. package/src/tests/__snapshots__/renderable.snapshot.test.ts.snap +19 -0
  310. package/src/tests/__snapshots__/scrollbox.test.ts.snap +29 -0
  311. package/src/tests/absolute-positioning.snapshot.test.ts +638 -0
  312. package/src/tests/allocator-stats.test.ts +38 -0
  313. package/src/tests/destroy-during-render.test.ts +200 -0
  314. package/src/tests/destroy-on-exit.fixture.ts +36 -0
  315. package/src/tests/destroy-on-exit.test.ts +41 -0
  316. package/src/tests/hover-cursor.test.ts +98 -0
  317. package/src/tests/native-span-feed-async.test.ts +173 -0
  318. package/src/tests/native-span-feed-close.test.ts +120 -0
  319. package/src/tests/native-span-feed-coverage.test.ts +227 -0
  320. package/src/tests/native-span-feed-edge-cases.test.ts +352 -0
  321. package/src/tests/native-span-feed-use-after-free.test.ts +45 -0
  322. package/src/tests/opacity.test.ts +123 -0
  323. package/src/tests/renderable.snapshot.test.ts +524 -0
  324. package/src/tests/renderable.test.ts +1281 -0
  325. package/src/tests/renderer.clock.test.ts +158 -0
  326. package/src/tests/renderer.console-startup.test.ts +185 -0
  327. package/src/tests/renderer.control.test.ts +425 -0
  328. package/src/tests/renderer.core-slot-binding.test.ts +952 -0
  329. package/src/tests/renderer.cursor.test.ts +26 -0
  330. package/src/tests/renderer.destroy-during-render.test.ts +147 -0
  331. package/src/tests/renderer.focus-restore.test.ts +257 -0
  332. package/src/tests/renderer.focus.test.ts +294 -0
  333. package/src/tests/renderer.idle.test.ts +219 -0
  334. package/src/tests/renderer.input.test.ts +2237 -0
  335. package/src/tests/renderer.kitty-flags.test.ts +195 -0
  336. package/src/tests/renderer.mouse.test.ts +1274 -0
  337. package/src/tests/renderer.palette.test.ts +629 -0
  338. package/src/tests/renderer.selection.test.ts +49 -0
  339. package/src/tests/renderer.slot-registry.test.ts +684 -0
  340. package/src/tests/renderer.useMouse.test.ts +47 -0
  341. package/src/tests/runtime-plugin-node-modules-cycle.fixture.ts +76 -0
  342. package/src/tests/runtime-plugin-node-modules-mjs.fixture.ts +43 -0
  343. package/src/tests/runtime-plugin-node-modules-no-bare-rewrite.fixture.ts +67 -0
  344. package/src/tests/runtime-plugin-node-modules-package-type-cache.fixture.ts +72 -0
  345. package/src/tests/runtime-plugin-node-modules-runtime-specifier.fixture.ts +44 -0
  346. package/src/tests/runtime-plugin-node-modules-scoped-package-bare-rewrite.fixture.ts +85 -0
  347. package/src/tests/runtime-plugin-path-alias.fixture.ts +43 -0
  348. package/src/tests/runtime-plugin-resolve-roots.fixture.ts +65 -0
  349. package/src/tests/runtime-plugin-support.fixture.ts +11 -0
  350. package/src/tests/runtime-plugin-support.test.ts +19 -0
  351. package/src/tests/runtime-plugin-windows-file-url.fixture.ts +30 -0
  352. package/src/tests/runtime-plugin.fixture.ts +40 -0
  353. package/src/tests/runtime-plugin.test.ts +354 -0
  354. package/src/tests/scrollbox-culling-bug.test.ts +114 -0
  355. package/src/tests/scrollbox-hitgrid-resize.test.ts +136 -0
  356. package/src/tests/scrollbox-hitgrid.test.ts +909 -0
  357. package/src/tests/scrollbox.test.ts +1530 -0
  358. package/src/tests/wrap-resize-perf.test.ts +276 -0
  359. package/src/tests/yoga-setters.test.ts +921 -0
  360. package/src/text-buffer-view.test.ts +705 -0
  361. package/src/text-buffer-view.ts +189 -0
  362. package/src/text-buffer.test.ts +347 -0
  363. package/src/text-buffer.ts +250 -0
  364. package/src/types.ts +161 -0
  365. package/src/utils.ts +88 -0
  366. package/src/zig/ansi.zig +268 -0
  367. package/src/zig/bench/README.md +50 -0
  368. package/src/zig/bench/buffer-draw-text-buffer_bench.zig +887 -0
  369. package/src/zig/bench/edit-buffer_bench.zig +476 -0
  370. package/src/zig/bench/native-span-feed_bench.zig +100 -0
  371. package/src/zig/bench/rope-markers_bench.zig +713 -0
  372. package/src/zig/bench/rope_bench.zig +514 -0
  373. package/src/zig/bench/styled-text_bench.zig +470 -0
  374. package/src/zig/bench/text-buffer-coords_bench.zig +362 -0
  375. package/src/zig/bench/text-buffer-view_bench.zig +459 -0
  376. package/src/zig/bench/text-chunk-graphemes_bench.zig +273 -0
  377. package/src/zig/bench/utf8_bench.zig +799 -0
  378. package/src/zig/bench-utils.zig +431 -0
  379. package/src/zig/bench.zig +217 -0
  380. package/src/zig/buffer-methods.zig +211 -0
  381. package/src/zig/buffer.zig +2281 -0
  382. package/src/zig/build.zig +289 -0
  383. package/src/zig/build.zig.zon +16 -0
  384. package/src/zig/edit-buffer.zig +825 -0
  385. package/src/zig/editor-view.zig +802 -0
  386. package/src/zig/event-bus.zig +13 -0
  387. package/src/zig/event-emitter.zig +65 -0
  388. package/src/zig/file-logger.zig +92 -0
  389. package/src/zig/grapheme.zig +599 -0
  390. package/src/zig/lib.zig +1854 -0
  391. package/src/zig/link.zig +333 -0
  392. package/src/zig/logger.zig +43 -0
  393. package/src/zig/mem-registry.zig +125 -0
  394. package/src/zig/native-span-feed-bench-lib.zig +7 -0
  395. package/src/zig/native-span-feed.zig +708 -0
  396. package/src/zig/renderer.zig +1393 -0
  397. package/src/zig/rope.zig +1220 -0
  398. package/src/zig/syntax-style.zig +161 -0
  399. package/src/zig/terminal.zig +987 -0
  400. package/src/zig/test.zig +72 -0
  401. package/src/zig/tests/README.md +18 -0
  402. package/src/zig/tests/buffer-methods_test.zig +1109 -0
  403. package/src/zig/tests/buffer_test.zig +2557 -0
  404. package/src/zig/tests/edit-buffer-history_test.zig +271 -0
  405. package/src/zig/tests/edit-buffer_test.zig +1689 -0
  406. package/src/zig/tests/editor-view_test.zig +3299 -0
  407. package/src/zig/tests/event-emitter_test.zig +249 -0
  408. package/src/zig/tests/grapheme_test.zig +1304 -0
  409. package/src/zig/tests/link_test.zig +190 -0
  410. package/src/zig/tests/mem-registry_test.zig +473 -0
  411. package/src/zig/tests/memory_leak_regression_test.zig +159 -0
  412. package/src/zig/tests/native-span-feed_test.zig +1264 -0
  413. package/src/zig/tests/renderer_test.zig +1017 -0
  414. package/src/zig/tests/rope-nested_test.zig +712 -0
  415. package/src/zig/tests/rope_fuzz_test.zig +238 -0
  416. package/src/zig/tests/rope_test.zig +2362 -0
  417. package/src/zig/tests/segment-merge.test.zig +148 -0
  418. package/src/zig/tests/syntax-style_test.zig +557 -0
  419. package/src/zig/tests/terminal_test.zig +754 -0
  420. package/src/zig/tests/text-buffer-drawing_test.zig +3237 -0
  421. package/src/zig/tests/text-buffer-highlights_test.zig +666 -0
  422. package/src/zig/tests/text-buffer-iterators_test.zig +776 -0
  423. package/src/zig/tests/text-buffer-segment_test.zig +320 -0
  424. package/src/zig/tests/text-buffer-selection_test.zig +1035 -0
  425. package/src/zig/tests/text-buffer-selection_viewport_test.zig +358 -0
  426. package/src/zig/tests/text-buffer-view_test.zig +3649 -0
  427. package/src/zig/tests/text-buffer_test.zig +2191 -0
  428. package/src/zig/tests/unicode-width-map.zon +3909 -0
  429. package/src/zig/tests/utf8_no_zwj_test.zig +260 -0
  430. package/src/zig/tests/utf8_test.zig +4057 -0
  431. package/src/zig/tests/utf8_wcwidth_cursor_test.zig +267 -0
  432. package/src/zig/tests/utf8_wcwidth_test.zig +357 -0
  433. package/src/zig/tests/word-wrap-editing_test.zig +498 -0
  434. package/src/zig/tests/wrap-cache-perf_test.zig +113 -0
  435. package/src/zig/text-buffer-iterators.zig +499 -0
  436. package/src/zig/text-buffer-segment.zig +404 -0
  437. package/src/zig/text-buffer-view.zig +1371 -0
  438. package/src/zig/text-buffer.zig +1180 -0
  439. package/src/zig/utf8.zig +1948 -0
  440. package/src/zig/utils.zig +9 -0
  441. package/src/zig-structs.ts +261 -0
  442. package/src/zig.ts +3884 -0
  443. package/tsconfig.build.json +24 -0
  444. package/tsconfig.json +27 -0
  445. package/3d/SpriteResourceManager.d.ts +0 -74
  446. package/3d/SpriteUtils.d.ts +0 -13
  447. package/3d/TextureUtils.d.ts +0 -24
  448. package/3d/ThreeRenderable.d.ts +0 -40
  449. package/3d/WGPURenderer.d.ts +0 -61
  450. package/3d/animation/ExplodingSpriteEffect.d.ts +0 -71
  451. package/3d/animation/PhysicsExplodingSpriteEffect.d.ts +0 -76
  452. package/3d/animation/SpriteAnimator.d.ts +0 -124
  453. package/3d/animation/SpriteParticleGenerator.d.ts +0 -62
  454. package/3d/canvas.d.ts +0 -44
  455. package/3d/index.d.ts +0 -12
  456. package/3d/physics/PlanckPhysicsAdapter.d.ts +0 -19
  457. package/3d/physics/RapierPhysicsAdapter.d.ts +0 -19
  458. package/3d/physics/physics-interface.d.ts +0 -27
  459. package/3d.d.ts +0 -2
  460. package/3d.js +0 -34041
  461. package/3d.js.map +0 -155
  462. package/LICENSE +0 -21
  463. package/NativeSpanFeed.d.ts +0 -41
  464. package/Renderable.d.ts +0 -334
  465. package/animation/Timeline.d.ts +0 -126
  466. package/ansi.d.ts +0 -13
  467. package/buffer.d.ts +0 -111
  468. package/console.d.ts +0 -144
  469. package/edit-buffer.d.ts +0 -98
  470. package/editor-view.d.ts +0 -73
  471. package/index-8fks7yv1.js +0 -411
  472. package/index-8fks7yv1.js.map +0 -10
  473. package/index-egy5e2rs.js +0 -12267
  474. package/index-egy5e2rs.js.map +0 -42
  475. package/index-tse8gzh0.js +0 -20614
  476. package/index-tse8gzh0.js.map +0 -67
  477. package/index.d.ts +0 -23
  478. package/index.js +0 -478
  479. package/index.js.map +0 -9
  480. package/lib/KeyHandler.d.ts +0 -61
  481. package/lib/RGBA.d.ts +0 -25
  482. package/lib/ascii.font.d.ts +0 -508
  483. package/lib/border.d.ts +0 -51
  484. package/lib/bunfs.d.ts +0 -7
  485. package/lib/clipboard.d.ts +0 -17
  486. package/lib/clock.d.ts +0 -15
  487. package/lib/data-paths.d.ts +0 -26
  488. package/lib/debounce.d.ts +0 -42
  489. package/lib/detect-links.d.ts +0 -6
  490. package/lib/env.d.ts +0 -42
  491. package/lib/extmarks-history.d.ts +0 -17
  492. package/lib/extmarks.d.ts +0 -89
  493. package/lib/hast-styled-text.d.ts +0 -17
  494. package/lib/index.d.ts +0 -21
  495. package/lib/keymapping.d.ts +0 -25
  496. package/lib/objects-in-viewport.d.ts +0 -24
  497. package/lib/output.capture.d.ts +0 -24
  498. package/lib/parse.keypress-kitty.d.ts +0 -2
  499. package/lib/parse.keypress.d.ts +0 -26
  500. package/lib/parse.mouse.d.ts +0 -30
  501. package/lib/paste.d.ts +0 -7
  502. package/lib/queue.d.ts +0 -15
  503. package/lib/renderable.validations.d.ts +0 -12
  504. package/lib/scroll-acceleration.d.ts +0 -43
  505. package/lib/selection.d.ts +0 -63
  506. package/lib/singleton.d.ts +0 -7
  507. package/lib/stdin-parser.d.ts +0 -87
  508. package/lib/styled-text.d.ts +0 -63
  509. package/lib/terminal-capability-detection.d.ts +0 -30
  510. package/lib/terminal-palette.d.ts +0 -50
  511. package/lib/tree-sitter/assets/update.d.ts +0 -11
  512. package/lib/tree-sitter/client.d.ts +0 -47
  513. package/lib/tree-sitter/default-parsers.d.ts +0 -2
  514. package/lib/tree-sitter/download-utils.d.ts +0 -21
  515. package/lib/tree-sitter/index.d.ts +0 -8
  516. package/lib/tree-sitter/parser.worker.d.ts +0 -1
  517. package/lib/tree-sitter/parsers-config.d.ts +0 -53
  518. package/lib/tree-sitter/resolve-ft.d.ts +0 -5
  519. package/lib/tree-sitter/types.d.ts +0 -82
  520. package/lib/tree-sitter-styled-text.d.ts +0 -14
  521. package/lib/validate-dir-name.d.ts +0 -1
  522. package/lib/yoga.options.d.ts +0 -32
  523. package/parser.worker.js +0 -899
  524. package/parser.worker.js.map +0 -12
  525. package/plugins/core-slot.d.ts +0 -72
  526. package/plugins/registry.d.ts +0 -42
  527. package/plugins/types.d.ts +0 -34
  528. package/post/effects.d.ts +0 -147
  529. package/post/filters.d.ts +0 -65
  530. package/post/matrices.d.ts +0 -20
  531. package/renderables/ASCIIFont.d.ts +0 -52
  532. package/renderables/Box.d.ts +0 -81
  533. package/renderables/Code.d.ts +0 -78
  534. package/renderables/Diff.d.ts +0 -142
  535. package/renderables/EditBufferRenderable.d.ts +0 -237
  536. package/renderables/FrameBuffer.d.ts +0 -16
  537. package/renderables/Input.d.ts +0 -67
  538. package/renderables/LineNumberRenderable.d.ts +0 -78
  539. package/renderables/Markdown.d.ts +0 -185
  540. package/renderables/ScrollBar.d.ts +0 -77
  541. package/renderables/ScrollBox.d.ts +0 -124
  542. package/renderables/Select.d.ts +0 -115
  543. package/renderables/Slider.d.ts +0 -47
  544. package/renderables/TabSelect.d.ts +0 -96
  545. package/renderables/Text.d.ts +0 -36
  546. package/renderables/TextBufferRenderable.d.ts +0 -105
  547. package/renderables/TextNode.d.ts +0 -91
  548. package/renderables/TextTable.d.ts +0 -140
  549. package/renderables/Textarea.d.ts +0 -63
  550. package/renderables/TimeToFirstDraw.d.ts +0 -24
  551. package/renderables/__tests__/renderable-test-utils.d.ts +0 -12
  552. package/renderables/composition/VRenderable.d.ts +0 -16
  553. package/renderables/composition/constructs.d.ts +0 -35
  554. package/renderables/composition/vnode.d.ts +0 -46
  555. package/renderables/index.d.ts +0 -23
  556. package/renderables/markdown-parser.d.ts +0 -10
  557. package/renderer.d.ts +0 -419
  558. package/runtime-plugin-support.d.ts +0 -3
  559. package/runtime-plugin-support.js +0 -29
  560. package/runtime-plugin-support.js.map +0 -10
  561. package/runtime-plugin.d.ts +0 -16
  562. package/runtime-plugin.js +0 -16
  563. package/runtime-plugin.js.map +0 -9
  564. package/syntax-style.d.ts +0 -54
  565. package/testing/manual-clock.d.ts +0 -17
  566. package/testing/mock-keys.d.ts +0 -81
  567. package/testing/mock-mouse.d.ts +0 -38
  568. package/testing/mock-tree-sitter-client.d.ts +0 -23
  569. package/testing/spy.d.ts +0 -7
  570. package/testing/test-recorder.d.ts +0 -61
  571. package/testing/test-renderer.d.ts +0 -23
  572. package/testing.d.ts +0 -6
  573. package/testing.js +0 -697
  574. package/testing.js.map +0 -15
  575. package/text-buffer-view.d.ts +0 -42
  576. package/text-buffer.d.ts +0 -67
  577. package/types.d.ts +0 -139
  578. package/utils.d.ts +0 -14
  579. package/zig-structs.d.ts +0 -155
  580. package/zig.d.ts +0 -353
  581. /package/{assets → src/lib/tree-sitter/assets}/javascript/highlights.scm +0 -0
  582. /package/{assets → src/lib/tree-sitter/assets}/javascript/tree-sitter-javascript.wasm +0 -0
  583. /package/{assets → src/lib/tree-sitter/assets}/markdown/highlights.scm +0 -0
  584. /package/{assets → src/lib/tree-sitter/assets}/markdown/injections.scm +0 -0
  585. /package/{assets → src/lib/tree-sitter/assets}/markdown/tree-sitter-markdown.wasm +0 -0
  586. /package/{assets → src/lib/tree-sitter/assets}/markdown_inline/highlights.scm +0 -0
  587. /package/{assets → src/lib/tree-sitter/assets}/markdown_inline/tree-sitter-markdown_inline.wasm +0 -0
  588. /package/{assets → src/lib/tree-sitter/assets}/typescript/highlights.scm +0 -0
  589. /package/{assets → src/lib/tree-sitter/assets}/typescript/tree-sitter-typescript.wasm +0 -0
  590. /package/{assets → src/lib/tree-sitter/assets}/zig/highlights.scm +0 -0
  591. /package/{assets → src/lib/tree-sitter/assets}/zig/tree-sitter-zig.wasm +0 -0
@@ -0,0 +1,3149 @@
1
+ import { Buffer } from "node:buffer"
2
+ import { describe, expect, it, afterAll, beforeEach, afterEach } from "bun:test"
3
+ import { createTestRenderer, type TestRenderer, type MockMouse, type MockInput } from "../../testing/test-renderer.js"
4
+ import { createTextareaRenderable } from "./renderable-test-utils.js"
5
+ import { KeyEvent } from "../../lib/KeyHandler.js"
6
+
7
+ // Helper function to create a KeyEvent from a string
8
+ function createKeyEvent(
9
+ input: string | { name: string; shift?: boolean; ctrl?: boolean; meta?: boolean; super?: boolean },
10
+ ): KeyEvent {
11
+ if (typeof input === "string") {
12
+ return new KeyEvent({
13
+ name: input,
14
+ sequence: input,
15
+ ctrl: false,
16
+ meta: false,
17
+ shift: false,
18
+ option: false,
19
+ number: false,
20
+ raw: input,
21
+ eventType: "press",
22
+ source: "raw",
23
+ })
24
+ } else {
25
+ return new KeyEvent({
26
+ name: input.name,
27
+ sequence: input.name === "space" ? " " : input.name,
28
+ ctrl: input.ctrl ?? false,
29
+ meta: input.meta ?? false,
30
+ shift: input.shift ?? false,
31
+ super: input.super ?? false,
32
+ option: false,
33
+ number: false,
34
+ raw: input.name,
35
+ eventType: "press",
36
+ source: "raw",
37
+ })
38
+ }
39
+ }
40
+
41
+ let currentRenderer: TestRenderer
42
+ let renderOnce: () => Promise<void>
43
+ let currentMouse: MockMouse
44
+ let currentMockInput: MockInput
45
+
46
+ describe("Textarea - Keybinding Tests", () => {
47
+ beforeEach(async () => {
48
+ ;({
49
+ renderer: currentRenderer,
50
+ renderOnce,
51
+ mockMouse: currentMouse,
52
+ mockInput: currentMockInput,
53
+ } = await createTestRenderer({
54
+ width: 80,
55
+ height: 24,
56
+ }))
57
+ })
58
+
59
+ afterEach(() => {
60
+ currentRenderer.destroy()
61
+ })
62
+
63
+ describe("Keyboard Input - Meta Key Bindings", () => {
64
+ it("should bind custom action to meta key", async () => {
65
+ const { textarea: editor } = await createTextareaRenderable(currentRenderer, renderOnce, {
66
+ initialValue: "Test",
67
+ width: 40,
68
+ height: 10,
69
+ keyBindings: [{ name: "b", meta: true, action: "buffer-home" }],
70
+ })
71
+
72
+ editor.focus()
73
+ editor.gotoLine(9999)
74
+
75
+ currentMockInput.pressKey("b", { meta: true })
76
+
77
+ const cursor = editor.logicalCursor
78
+ expect(cursor.row).toBe(0)
79
+ expect(cursor.col).toBe(0)
80
+ })
81
+
82
+ it("should bind meta key actions", async () => {
83
+ const { textarea: editor } = await createTextareaRenderable(currentRenderer, renderOnce, {
84
+ initialValue: "Test",
85
+ width: 40,
86
+ height: 10,
87
+ keyBindings: [{ name: "f", meta: true, action: "buffer-end" }],
88
+ })
89
+
90
+ editor.focus()
91
+
92
+ currentMockInput.pressKey("f", { meta: true })
93
+
94
+ const cursor = editor.logicalCursor
95
+ expect(cursor.row).toBe(0)
96
+ })
97
+
98
+ it("should work with meta key for navigation", async () => {
99
+ const { textarea: editor } = await createTextareaRenderable(currentRenderer, renderOnce, {
100
+ initialValue: "Line 1\nLine 2",
101
+ width: 40,
102
+ height: 10,
103
+ keyBindings: [{ name: "j", meta: true, action: "move-down" }],
104
+ })
105
+
106
+ editor.focus()
107
+ expect(editor.logicalCursor.row).toBe(0)
108
+
109
+ currentMockInput.pressKey("j", { meta: true })
110
+ expect(editor.logicalCursor.row).toBe(1)
111
+ })
112
+
113
+ it("should allow meta key binding override", async () => {
114
+ const { textarea: editor } = await createTextareaRenderable(currentRenderer, renderOnce, {
115
+ initialValue: "Line 1\nLine 2\nLine 3",
116
+ width: 40,
117
+ height: 10,
118
+ keyBindings: [{ name: "k", meta: true, action: "move-up" }],
119
+ })
120
+
121
+ editor.focus()
122
+ editor.gotoLine(2)
123
+ expect(editor.logicalCursor.row).toBe(2)
124
+
125
+ currentMockInput.pressKey("k", { meta: true })
126
+ expect(editor.logicalCursor.row).toBe(1)
127
+ })
128
+
129
+ it("should work with Meta+Arrow keys", async () => {
130
+ const { textarea: editor } = await createTextareaRenderable(currentRenderer, renderOnce, {
131
+ initialValue: "ABC",
132
+ width: 40,
133
+ height: 10,
134
+ keyBindings: [
135
+ { name: "left", meta: true, action: "line-home" },
136
+ { name: "right", meta: true, action: "line-end" },
137
+ ],
138
+ })
139
+
140
+ editor.focus()
141
+ for (let i = 0; i < 2; i++) {
142
+ editor.moveCursorRight()
143
+ }
144
+ expect(editor.logicalCursor.col).toBe(2)
145
+
146
+ currentMockInput.pressArrow("left", { meta: true })
147
+ expect(editor.logicalCursor.col).toBe(0)
148
+
149
+ currentMockInput.pressArrow("right", { meta: true })
150
+ expect(editor.logicalCursor.col).toBe(3)
151
+ })
152
+
153
+ it("should support meta with shift modifier", async () => {
154
+ const { textarea: editor } = await createTextareaRenderable(currentRenderer, renderOnce, {
155
+ initialValue: "Hello World",
156
+ width: 40,
157
+ height: 10,
158
+ keyBindings: [{ name: "H", meta: true, shift: true, action: "line-home" }],
159
+ })
160
+
161
+ editor.focus()
162
+ editor.gotoLine(9999)
163
+ expect(editor.logicalCursor.col).toBe(11)
164
+
165
+ currentMockInput.pressKey("h", { meta: true, shift: true })
166
+
167
+ expect(editor.logicalCursor.col).toBe(0)
168
+ })
169
+
170
+ it("should not trigger action without meta when meta binding exists", async () => {
171
+ const { textarea: editor } = await createTextareaRenderable(currentRenderer, renderOnce, {
172
+ initialValue: "Test",
173
+ width: 40,
174
+ height: 10,
175
+ keyBindings: [{ name: "x", meta: true, action: "delete-line" }],
176
+ })
177
+
178
+ editor.focus()
179
+
180
+ currentMockInput.pressKey("x")
181
+ expect(editor.plainText).toBe("xTest")
182
+
183
+ currentMockInput.pressKey("x", { meta: true })
184
+ expect(editor.plainText).toBe("")
185
+ })
186
+
187
+ it("should update keyBindings dynamically with setter", async () => {
188
+ const { textarea: editor } = await createTextareaRenderable(currentRenderer, renderOnce, {
189
+ initialValue: "Test",
190
+ width: 40,
191
+ height: 10,
192
+ })
193
+
194
+ editor.focus()
195
+ editor.gotoLine(9999)
196
+
197
+ currentMockInput.pressKey("b", { meta: true })
198
+ expect(editor.logicalCursor.row).toBe(0)
199
+ expect(editor.logicalCursor.col).toBe(0)
200
+
201
+ editor.keyBindings = [{ name: "b", meta: true, action: "buffer-end" }]
202
+
203
+ editor.gotoLine(0)
204
+ expect(editor.logicalCursor.row).toBe(0)
205
+
206
+ currentMockInput.pressKey("b", { meta: true })
207
+ expect(editor.logicalCursor.row).toBe(0)
208
+ })
209
+
210
+ it("should merge new keyBindings with defaults", async () => {
211
+ const { textarea: editor } = await createTextareaRenderable(currentRenderer, renderOnce, {
212
+ initialValue: "Line 1\nLine 2",
213
+ width: 40,
214
+ height: 10,
215
+ })
216
+
217
+ editor.focus()
218
+
219
+ currentMockInput.pressArrow("right")
220
+ expect(editor.logicalCursor.col).toBe(1)
221
+
222
+ editor.keyBindings = [{ name: "d", meta: true, action: "delete-line" }]
223
+
224
+ currentMockInput.pressArrow("right")
225
+ expect(editor.logicalCursor.col).toBe(2)
226
+
227
+ currentMockInput.pressKey("d", { meta: true })
228
+ expect(editor.plainText).toBe("Line 2")
229
+ })
230
+
231
+ it("should override default keyBindings with new bindings", async () => {
232
+ const { textarea: editor } = await createTextareaRenderable(currentRenderer, renderOnce, {
233
+ initialValue: "hello world",
234
+ width: 40,
235
+ height: 10,
236
+ })
237
+
238
+ editor.focus()
239
+
240
+ currentMockInput.pressKey("f", { meta: true })
241
+ expect(editor.logicalCursor.col).toBe(6)
242
+
243
+ editor.keyBindings = [{ name: "f", meta: true, action: "buffer-end" }]
244
+
245
+ editor.gotoLine(0)
246
+ currentMockInput.pressKey("f", { meta: true })
247
+ expect(editor.logicalCursor.row).toBe(0)
248
+ })
249
+
250
+ it("should override return/enter keys to swap newline and submit actions", async () => {
251
+ let submitCalled = false
252
+ const { textarea: editor } = await createTextareaRenderable(currentRenderer, renderOnce, {
253
+ initialValue: "Line 1",
254
+ width: 40,
255
+ height: 10,
256
+ onSubmit: () => {
257
+ submitCalled = true
258
+ },
259
+ })
260
+
261
+ editor.focus()
262
+ editor.gotoLine(9999)
263
+
264
+ currentMockInput.pressEnter()
265
+ expect(editor.plainText).toBe("Line 1\n")
266
+ expect(submitCalled).toBe(false)
267
+
268
+ currentMockInput.pressEnter({ meta: true })
269
+ expect(submitCalled).toBe(true)
270
+ submitCalled = false
271
+
272
+ editor.keyBindings = [
273
+ { name: "return", meta: true, action: "newline" },
274
+ { name: "linefeed", meta: true, action: "newline" },
275
+ { name: "return", action: "submit" },
276
+ { name: "linefeed", action: "submit" },
277
+ ]
278
+
279
+ currentMockInput.pressEnter()
280
+ expect(submitCalled).toBe(true)
281
+ submitCalled = false
282
+
283
+ currentMockInput.pressEnter({ meta: true })
284
+ expect(editor.plainText).toBe("Line 1\n\n")
285
+ expect(submitCalled).toBe(false)
286
+ })
287
+ })
288
+
289
+ describe("Key Event Handling - Modifier Keys", () => {
290
+ let kittyRenderer: TestRenderer
291
+ let kittyRenderOnce: () => Promise<void>
292
+ let kittyMockInput: MockInput
293
+
294
+ beforeEach(async () => {
295
+ ;({
296
+ renderer: kittyRenderer,
297
+ renderOnce: kittyRenderOnce,
298
+ mockInput: kittyMockInput,
299
+ } = await createTestRenderer({
300
+ width: 80,
301
+ height: 24,
302
+ kittyKeyboard: true,
303
+ }))
304
+ })
305
+
306
+ afterEach(() => {
307
+ kittyRenderer.destroy()
308
+ })
309
+
310
+ it("should not insert text when ctrl modifier is pressed", async () => {
311
+ const { textarea: editor } = await createTextareaRenderable(kittyRenderer, kittyRenderOnce, {
312
+ initialValue: "",
313
+ width: 40,
314
+ height: 10,
315
+ })
316
+
317
+ editor.focus()
318
+
319
+ // Try to type 'a' with ctrl - should not insert
320
+ kittyMockInput.pressKey("a", { ctrl: true })
321
+ expect(editor.plainText).toBe("")
322
+
323
+ // Try to type 'x' with ctrl - should not insert
324
+ kittyMockInput.pressKey("x", { ctrl: true })
325
+ expect(editor.plainText).toBe("")
326
+ })
327
+
328
+ it("should not insert text when meta modifier is pressed", async () => {
329
+ const { textarea: editor } = await createTextareaRenderable(kittyRenderer, kittyRenderOnce, {
330
+ initialValue: "",
331
+ width: 40,
332
+ height: 10,
333
+ })
334
+
335
+ editor.focus()
336
+
337
+ // Try to type 'a' with meta - should not insert
338
+ kittyMockInput.pressKey("a", { meta: true })
339
+ expect(editor.plainText).toBe("")
340
+
341
+ // Try to type 'x' with meta - should not insert
342
+ kittyMockInput.pressKey("x", { meta: true })
343
+ expect(editor.plainText).toBe("")
344
+ })
345
+
346
+ it("should not insert text when super modifier is pressed", async () => {
347
+ const { textarea: editor } = await createTextareaRenderable(kittyRenderer, kittyRenderOnce, {
348
+ initialValue: "",
349
+ width: 40,
350
+ height: 10,
351
+ })
352
+
353
+ editor.focus()
354
+
355
+ // Try to type 'a' with super - should not insert
356
+ kittyMockInput.pressKey("a", { super: true })
357
+ expect(editor.plainText).toBe("")
358
+
359
+ // Try to type 'x' with super - should not insert
360
+ kittyMockInput.pressKey("x", { super: true })
361
+ expect(editor.plainText).toBe("")
362
+ })
363
+
364
+ it("should not insert text when hyper modifier is pressed", async () => {
365
+ const { textarea: editor } = await createTextareaRenderable(kittyRenderer, kittyRenderOnce, {
366
+ initialValue: "",
367
+ width: 40,
368
+ height: 10,
369
+ })
370
+
371
+ editor.focus()
372
+
373
+ // Try to type 'a' with hyper - should not insert
374
+ kittyMockInput.pressKey("a", { hyper: true })
375
+ expect(editor.plainText).toBe("")
376
+
377
+ // Try to type 'x' with hyper - should not insert
378
+ kittyMockInput.pressKey("x", { hyper: true })
379
+ expect(editor.plainText).toBe("")
380
+ })
381
+
382
+ it("should not insert text when multiple modifiers are pressed", async () => {
383
+ const { textarea: editor } = await createTextareaRenderable(kittyRenderer, kittyRenderOnce, {
384
+ initialValue: "",
385
+ width: 40,
386
+ height: 10,
387
+ })
388
+
389
+ editor.focus()
390
+
391
+ // Try to type with ctrl+meta - should not insert
392
+ kittyMockInput.pressKey("a", { ctrl: true, meta: true })
393
+ expect(editor.plainText).toBe("")
394
+
395
+ // Try to type with ctrl+super - should not insert
396
+ kittyMockInput.pressKey("b", { ctrl: true, super: true })
397
+ expect(editor.plainText).toBe("")
398
+
399
+ // Try to type with meta+hyper - should not insert
400
+ kittyMockInput.pressKey("c", { meta: true, hyper: true })
401
+ expect(editor.plainText).toBe("")
402
+ })
403
+
404
+ it("should insert text when only shift modifier is pressed", async () => {
405
+ const { textarea: editor } = await createTextareaRenderable(kittyRenderer, kittyRenderOnce, {
406
+ initialValue: "",
407
+ width: 40,
408
+ height: 10,
409
+ })
410
+
411
+ editor.focus()
412
+
413
+ // Shift is okay for uppercase letters
414
+ kittyMockInput.pressKey("A", { shift: true })
415
+ expect(editor.plainText).toBe("A")
416
+
417
+ kittyMockInput.pressKey("B", { shift: true })
418
+ expect(editor.plainText).toBe("AB")
419
+ })
420
+
421
+ it("should not insert text when Caps Lock key is pressed", async () => {
422
+ const { textarea: editor } = await createTextareaRenderable(kittyRenderer, kittyRenderOnce, {
423
+ initialValue: "",
424
+ width: 40,
425
+ height: 10,
426
+ })
427
+
428
+ editor.focus()
429
+
430
+ kittyRenderer.stdin.emit("data", Buffer.from("\x1b[57358u"))
431
+ expect(editor.plainText).toBe("")
432
+ })
433
+ })
434
+
435
+ describe("Key Event Handling", () => {
436
+ it("should only handle KeyEvents, not raw escape sequences", async () => {
437
+ const { textarea: editor } = await createTextareaRenderable(currentRenderer, renderOnce, {
438
+ initialValue: "",
439
+ width: 40,
440
+ height: 10,
441
+ })
442
+
443
+ editor.focus()
444
+
445
+ const rawEscapeSequence = "\x1b[<35;86;19M"
446
+ const handled = editor.handleKeyPress(createKeyEvent(rawEscapeSequence))
447
+
448
+ expect(handled).toBe(false)
449
+
450
+ expect(editor.plainText).toBe("")
451
+ })
452
+
453
+ it("should not insert control sequences into text", async () => {
454
+ const { textarea: editor } = await createTextareaRenderable(currentRenderer, renderOnce, {
455
+ initialValue: "Hello",
456
+ width: 40,
457
+ height: 10,
458
+ })
459
+
460
+ editor.focus()
461
+
462
+ // Try various control sequences that should NOT be inserted
463
+ const controlSequences = [
464
+ "\x1b[A", // Arrow up
465
+ "\x1b[B", // Arrow down
466
+ "\x1b[C", // Arrow right
467
+ "\x1b[D", // Arrow left
468
+ "\x1b[?1004h", // Focus tracking
469
+ "\x1b[?2004h", // Bracketed paste
470
+ "\x1b[<0;10;10M", // Mouse event
471
+ ]
472
+
473
+ for (const seq of controlSequences) {
474
+ const before = editor.plainText
475
+ editor.handleKeyPress(createKeyEvent(seq))
476
+ const after = editor.plainText
477
+
478
+ // Content should not change for control sequences
479
+ expect(after).toBe(before)
480
+ }
481
+ })
482
+
483
+ it("should handle printable characters via handleKeyPress", async () => {
484
+ const { textarea: editor } = await createTextareaRenderable(currentRenderer, renderOnce, {
485
+ initialValue: "",
486
+ width: 40,
487
+ height: 10,
488
+ })
489
+
490
+ editor.focus()
491
+
492
+ // These should be handled
493
+ const handled1 = editor.handleKeyPress(createKeyEvent("a"))
494
+ expect(handled1).toBe(true)
495
+ expect(editor.plainText).toBe("a")
496
+
497
+ const handled2 = editor.handleKeyPress(createKeyEvent("b"))
498
+ expect(handled2).toBe(true)
499
+ expect(editor.plainText).toBe("ab")
500
+ })
501
+
502
+ it("should handle multi-byte Unicode characters (emoji, CJK)", async () => {
503
+ const { textarea: editor } = await createTextareaRenderable(currentRenderer, renderOnce, {
504
+ initialValue: "",
505
+ width: 40,
506
+ height: 10,
507
+ })
508
+
509
+ editor.focus()
510
+
511
+ // Emoji (multi-byte UTF-8)
512
+ const emojiHandled = editor.handleKeyPress(createKeyEvent("🌟"))
513
+ expect(emojiHandled).toBe(true)
514
+ expect(editor.plainText).toBe("🌟")
515
+
516
+ // CJK characters (multi-byte UTF-8)
517
+ const cjkHandled = editor.handleKeyPress(createKeyEvent("世"))
518
+ expect(cjkHandled).toBe(true)
519
+ expect(editor.plainText).toBe("🌟世")
520
+
521
+ // Another emoji
522
+ editor.insertText(" ")
523
+ const emoji2Handled = editor.handleKeyPress(createKeyEvent("👍"))
524
+ expect(emoji2Handled).toBe(true)
525
+ expect(editor.plainText).toBe("🌟世 👍")
526
+ })
527
+
528
+ it("should filter escape sequences when they have non-printable characters", async () => {
529
+ const { textarea: editor } = await createTextareaRenderable(currentRenderer, renderOnce, {
530
+ initialValue: "Test",
531
+ width: 40,
532
+ height: 10,
533
+ })
534
+
535
+ editor.focus()
536
+ editor.gotoLine(9999) // Move to end
537
+
538
+ // Escape character (0x1b) - should not be inserted
539
+ const escapeChar = String.fromCharCode(0x1b)
540
+ const handled = editor.handleKeyPress(createKeyEvent(escapeChar))
541
+
542
+ // Should not insert escape character
543
+ expect(editor.plainText).toBe("Test")
544
+ })
545
+ })
546
+
547
+ describe("Key Bindings", () => {
548
+ it("should use default keybindings", async () => {
549
+ const { textarea: editor } = await createTextareaRenderable(currentRenderer, renderOnce, {
550
+ initialValue: "Hello World",
551
+ width: 40,
552
+ height: 10,
553
+ })
554
+
555
+ editor.focus()
556
+
557
+ currentMockInput.pressArrow("right")
558
+ expect(editor.logicalCursor.col).toBe(1)
559
+
560
+ currentMockInput.pressKey("HOME")
561
+ expect(editor.logicalCursor.col).toBe(0)
562
+
563
+ currentMockInput.pressKey("END")
564
+ expect(editor.logicalCursor.col).toBe(11)
565
+ })
566
+
567
+ it("should allow custom keybindings to override defaults", async () => {
568
+ const { textarea: editor } = await createTextareaRenderable(currentRenderer, renderOnce, {
569
+ initialValue: "Hello World",
570
+ width: 40,
571
+ height: 10,
572
+ keyBindings: [{ name: "j", action: "move-left" }],
573
+ })
574
+
575
+ editor.focus()
576
+ editor.gotoLine(9999)
577
+ expect(editor.logicalCursor.col).toBe(11)
578
+
579
+ currentMockInput.pressKey("j")
580
+ expect(editor.logicalCursor.col).toBe(10)
581
+ })
582
+
583
+ it("should map multiple custom keys to the same action", async () => {
584
+ const { textarea: editor } = await createTextareaRenderable(currentRenderer, renderOnce, {
585
+ initialValue: "Hello World",
586
+ width: 40,
587
+ height: 10,
588
+ keyBindings: [
589
+ { name: "h", action: "move-left" },
590
+ { name: "j", action: "move-down" },
591
+ { name: "k", action: "move-up" },
592
+ { name: "l", action: "move-right" },
593
+ ],
594
+ })
595
+
596
+ editor.focus()
597
+
598
+ currentMockInput.pressKey("l")
599
+ expect(editor.logicalCursor.col).toBe(1)
600
+
601
+ currentMockInput.pressKey("l")
602
+ expect(editor.logicalCursor.col).toBe(2)
603
+
604
+ currentMockInput.pressKey("h")
605
+ expect(editor.logicalCursor.col).toBe(1)
606
+
607
+ currentMockInput.pressKey("h")
608
+ expect(editor.logicalCursor.col).toBe(0)
609
+ })
610
+
611
+ it("should support custom keybindings with ctrl modifier", async () => {
612
+ const { textarea: editor } = await createTextareaRenderable(currentRenderer, renderOnce, {
613
+ initialValue: "Line 1\nLine 2\nLine 3",
614
+ width: 40,
615
+ height: 10,
616
+ keyBindings: [{ name: "g", ctrl: true, action: "buffer-home" }],
617
+ })
618
+
619
+ editor.focus()
620
+ editor.gotoLine(9999)
621
+ expect(editor.logicalCursor.row).toBe(2)
622
+
623
+ currentMockInput.pressKey("g", { ctrl: true })
624
+ expect(editor.logicalCursor.row).toBe(0)
625
+ expect(editor.logicalCursor.col).toBe(0)
626
+ })
627
+
628
+ it("should support custom keybindings with shift modifier", async () => {
629
+ const { textarea: editor } = await createTextareaRenderable(currentRenderer, renderOnce, {
630
+ initialValue: "Hello World",
631
+ width: 40,
632
+ height: 10,
633
+ selectable: true,
634
+ keyBindings: [{ name: "l", shift: true, action: "select-right" }],
635
+ })
636
+
637
+ editor.focus()
638
+
639
+ currentMockInput.pressKey("L", { shift: true })
640
+ expect(editor.hasSelection()).toBe(true)
641
+ expect(editor.getSelectedText()).toBe("H")
642
+
643
+ currentMockInput.pressKey("L", { shift: true })
644
+ expect(editor.getSelectedText()).toBe("He")
645
+ })
646
+
647
+ it("should support custom keybindings with alt modifier", async () => {
648
+ const { textarea: editor } = await createTextareaRenderable(currentRenderer, renderOnce, {
649
+ initialValue: "Line 1\nLine 2\nLine 3",
650
+ width: 40,
651
+ height: 10,
652
+ keyBindings: [{ name: "b", ctrl: true, action: "buffer-home" }],
653
+ })
654
+
655
+ editor.focus()
656
+ editor.gotoLine(2)
657
+
658
+ currentMockInput.pressKey("b", { ctrl: true })
659
+ expect(editor.logicalCursor.row).toBe(0)
660
+ expect(editor.logicalCursor.col).toBe(0)
661
+ })
662
+
663
+ it("should support keybindings with multiple modifiers", async () => {
664
+ const { textarea: editor } = await createTextareaRenderable(currentRenderer, renderOnce, {
665
+ initialValue: "Hello World",
666
+ width: 40,
667
+ height: 10,
668
+ selectable: true,
669
+ keyBindings: [{ name: "right", ctrl: true, shift: true, action: "select-line-end" }],
670
+ })
671
+
672
+ editor.focus()
673
+
674
+ currentMockInput.pressArrow("right", { ctrl: true, shift: true })
675
+ expect(editor.hasSelection()).toBe(true)
676
+ expect(editor.getSelectedText()).toBe("Hello World")
677
+ })
678
+
679
+ it("should map newline action to custom key", async () => {
680
+ const { textarea: editor } = await createTextareaRenderable(currentRenderer, renderOnce, {
681
+ initialValue: "Hello",
682
+ width: 40,
683
+ height: 10,
684
+ keyBindings: [{ name: "n", ctrl: true, action: "newline" }],
685
+ })
686
+
687
+ editor.focus()
688
+ editor.gotoLine(9999)
689
+
690
+ currentMockInput.pressKey("n", { ctrl: true })
691
+ expect(editor.plainText).toBe("Hello\n")
692
+ })
693
+
694
+ it("should map backspace action to custom key", async () => {
695
+ const { textarea: editor } = await createTextareaRenderable(currentRenderer, renderOnce, {
696
+ initialValue: "Hello",
697
+ width: 40,
698
+ height: 10,
699
+ keyBindings: [{ name: "h", ctrl: true, action: "backspace" }],
700
+ })
701
+
702
+ editor.focus()
703
+ editor.gotoLine(9999)
704
+
705
+ currentMockInput.pressKey("h", { ctrl: true })
706
+ expect(editor.plainText).toBe("Hell")
707
+ })
708
+
709
+ it("should map delete action to custom key", async () => {
710
+ const { textarea: editor } = await createTextareaRenderable(currentRenderer, renderOnce, {
711
+ initialValue: "Hello",
712
+ width: 40,
713
+ height: 10,
714
+ keyBindings: [{ name: "d", ctrl: false, action: "delete" }],
715
+ })
716
+
717
+ editor.focus()
718
+
719
+ currentMockInput.pressKey("d")
720
+ expect(editor.plainText).toBe("ello")
721
+ })
722
+
723
+ it("should map line-home and line-end to custom keys", async () => {
724
+ const { textarea: editor } = await createTextareaRenderable(currentRenderer, renderOnce, {
725
+ initialValue: "Hello World",
726
+ width: 40,
727
+ height: 10,
728
+ keyBindings: [
729
+ { name: "a", action: "line-home" },
730
+ { name: "e", action: "line-end" },
731
+ ],
732
+ })
733
+
734
+ editor.focus()
735
+ editor.moveCursorRight()
736
+ editor.moveCursorRight()
737
+ expect(editor.logicalCursor.col).toBe(2)
738
+
739
+ currentMockInput.pressKey("a")
740
+ expect(editor.logicalCursor.col).toBe(0)
741
+
742
+ currentMockInput.pressKey("e")
743
+ expect(editor.logicalCursor.col).toBe(11)
744
+ })
745
+
746
+ it("should override default shift+home and shift+end keybindings", async () => {
747
+ const { textarea: editor } = await createTextareaRenderable(currentRenderer, renderOnce, {
748
+ initialValue: "Hello World",
749
+ width: 40,
750
+ height: 10,
751
+ selectable: true,
752
+ keyBindings: [
753
+ { name: "home", shift: true, action: "buffer-home" },
754
+ { name: "end", shift: true, action: "buffer-end" },
755
+ ],
756
+ })
757
+
758
+ editor.focus()
759
+ for (let i = 0; i < 6; i++) {
760
+ editor.moveCursorRight()
761
+ }
762
+ expect(editor.logicalCursor.col).toBe(6)
763
+
764
+ currentMockInput.pressKey("HOME", { shift: true })
765
+ expect(editor.hasSelection()).toBe(false)
766
+ expect(editor.logicalCursor.row).toBe(0)
767
+ expect(editor.logicalCursor.col).toBe(0)
768
+
769
+ editor.moveCursorRight()
770
+ currentMockInput.pressKey("END", { shift: true })
771
+ expect(editor.hasSelection()).toBe(false)
772
+ expect(editor.logicalCursor.row).toBe(0)
773
+ })
774
+
775
+ it("should map undo and redo actions to custom keys", async () => {
776
+ const { textarea: editor } = await createTextareaRenderable(currentRenderer, renderOnce, {
777
+ initialValue: "",
778
+ width: 40,
779
+ height: 10,
780
+ keyBindings: [
781
+ { name: "u", action: "undo" },
782
+ { name: "r", action: "redo" },
783
+ ],
784
+ })
785
+
786
+ editor.focus()
787
+
788
+ currentMockInput.pressKey("H")
789
+ currentMockInput.pressKey("i")
790
+ expect(editor.plainText).toBe("Hi")
791
+
792
+ currentMockInput.pressKey("u")
793
+ expect(editor.plainText).toBe("H")
794
+
795
+ currentMockInput.pressKey("r")
796
+ expect(editor.plainText).toBe("Hi")
797
+ })
798
+
799
+ it("should map delete-line action to custom key", async () => {
800
+ const { textarea: editor } = await createTextareaRenderable(currentRenderer, renderOnce, {
801
+ initialValue: "Line 1\nLine 2\nLine 3",
802
+ width: 40,
803
+ height: 10,
804
+ keyBindings: [{ name: "x", ctrl: true, action: "delete-line" }],
805
+ })
806
+
807
+ editor.focus()
808
+ editor.gotoLine(1)
809
+
810
+ currentMockInput.pressKey("x", { ctrl: true })
811
+ expect(editor.plainText).toBe("Line 1\nLine 3")
812
+ })
813
+
814
+ it("should map delete-to-line-end action to custom key", async () => {
815
+ const { textarea: editor } = await createTextareaRenderable(currentRenderer, renderOnce, {
816
+ initialValue: "Hello World",
817
+ width: 40,
818
+ height: 10,
819
+ keyBindings: [{ name: "k", action: "delete-to-line-end" }],
820
+ })
821
+
822
+ editor.focus()
823
+ for (let i = 0; i < 6; i++) {
824
+ editor.moveCursorRight()
825
+ }
826
+
827
+ currentMockInput.pressKey("k")
828
+ expect(editor.plainText).toBe("Hello ")
829
+ })
830
+
831
+ it("should delete from cursor to line start with ctrl+u", async () => {
832
+ const { textarea: editor } = await createTextareaRenderable(currentRenderer, renderOnce, {
833
+ initialValue: "Hello World",
834
+ width: 40,
835
+ height: 10,
836
+ })
837
+
838
+ editor.focus()
839
+ for (let i = 0; i < 6; i++) {
840
+ editor.moveCursorRight()
841
+ }
842
+
843
+ currentMockInput.pressKey("u", { ctrl: true })
844
+ expect(editor.plainText).toBe("World")
845
+ expect(editor.logicalCursor.col).toBe(0)
846
+ })
847
+
848
+ it("should map delete-to-line-start action to custom key", async () => {
849
+ const { textarea: editor } = await createTextareaRenderable(currentRenderer, renderOnce, {
850
+ initialValue: "Hello World",
851
+ width: 40,
852
+ height: 10,
853
+ keyBindings: [{ name: "x", ctrl: true, action: "delete-to-line-start" }],
854
+ })
855
+
856
+ editor.focus()
857
+ for (let i = 0; i < 6; i++) {
858
+ editor.moveCursorRight()
859
+ }
860
+
861
+ currentMockInput.pressKey("x", { ctrl: true })
862
+ expect(editor.plainText).toBe("World")
863
+ expect(editor.logicalCursor.col).toBe(0)
864
+ })
865
+
866
+ it("should delete from cursor to line end with ctrl+k in multiline text", async () => {
867
+ const { textarea: editor } = await createTextareaRenderable(currentRenderer, renderOnce, {
868
+ initialValue: "Line 1 content\nLine 2 content\nLine 3 content",
869
+ width: 40,
870
+ height: 10,
871
+ })
872
+
873
+ editor.focus()
874
+ for (let i = 0; i < 7; i++) {
875
+ editor.moveCursorRight()
876
+ }
877
+
878
+ currentMockInput.pressKey("k", { ctrl: true })
879
+ expect(editor.plainText).toBe("Line 1 \nLine 2 content\nLine 3 content")
880
+ expect(editor.logicalCursor.col).toBe(7)
881
+ expect(editor.logicalCursor.row).toBe(0)
882
+ })
883
+
884
+ it("should delete from cursor to line end with ctrl+k on line 2", async () => {
885
+ const { textarea: editor } = await createTextareaRenderable(currentRenderer, renderOnce, {
886
+ initialValue: "Line 1 content\nLine 2 content\nLine 3 content",
887
+ width: 40,
888
+ height: 10,
889
+ })
890
+
891
+ editor.focus()
892
+ editor.gotoLine(1)
893
+ for (let i = 0; i < 7; i++) {
894
+ editor.moveCursorRight()
895
+ }
896
+
897
+ currentMockInput.pressKey("k", { ctrl: true })
898
+ expect(editor.plainText).toBe("Line 1 content\nLine 2 \nLine 3 content")
899
+ expect(editor.logicalCursor.col).toBe(7)
900
+ expect(editor.logicalCursor.row).toBe(1)
901
+ })
902
+
903
+ it("should delete from start to cursor with ctrl+u in multiline text", async () => {
904
+ const { textarea: editor } = await createTextareaRenderable(currentRenderer, renderOnce, {
905
+ initialValue: "Line 1 content\nLine 2 content\nLine 3 content",
906
+ width: 40,
907
+ height: 10,
908
+ })
909
+
910
+ editor.focus()
911
+ for (let i = 0; i < 7; i++) {
912
+ editor.moveCursorRight()
913
+ }
914
+
915
+ currentMockInput.pressKey("u", { ctrl: true })
916
+ expect(editor.plainText).toBe("content\nLine 2 content\nLine 3 content")
917
+ expect(editor.logicalCursor.col).toBe(0)
918
+ expect(editor.logicalCursor.row).toBe(0)
919
+ })
920
+
921
+ it("should delete from start to cursor with ctrl+u on line 2", async () => {
922
+ const { textarea: editor } = await createTextareaRenderable(currentRenderer, renderOnce, {
923
+ initialValue: "Line 1 content\nLine 2 content\nLine 3 content",
924
+ width: 40,
925
+ height: 10,
926
+ })
927
+
928
+ editor.focus()
929
+ editor.gotoLine(1)
930
+ for (let i = 0; i < 7; i++) {
931
+ editor.moveCursorRight()
932
+ }
933
+
934
+ currentMockInput.pressKey("u", { ctrl: true })
935
+ expect(editor.plainText).toBe("Line 1 content\ncontent\nLine 3 content")
936
+ expect(editor.logicalCursor.col).toBe(0)
937
+ expect(editor.logicalCursor.row).toBe(1)
938
+ })
939
+
940
+ it("should do nothing with ctrl+k when cursor is at end of line", async () => {
941
+ const { textarea: editor } = await createTextareaRenderable(currentRenderer, renderOnce, {
942
+ initialValue: "Line 1 content\nLine 2 content",
943
+ width: 40,
944
+ height: 10,
945
+ })
946
+
947
+ editor.focus()
948
+ editor.gotoLineEnd()
949
+
950
+ currentMockInput.pressKey("k", { ctrl: true })
951
+ expect(editor.plainText).toBe("Line 1 content\nLine 2 content")
952
+ expect(editor.logicalCursor.col).toBe(14)
953
+ })
954
+
955
+ it("should do nothing with ctrl+u when cursor is at start of line", async () => {
956
+ const { textarea: editor } = await createTextareaRenderable(currentRenderer, renderOnce, {
957
+ initialValue: "Line 1 content\nLine 2 content",
958
+ width: 40,
959
+ height: 10,
960
+ })
961
+
962
+ editor.focus()
963
+
964
+ currentMockInput.pressKey("u", { ctrl: true })
965
+ expect(editor.plainText).toBe("Line 1 content\nLine 2 content")
966
+ expect(editor.logicalCursor.col).toBe(0)
967
+ })
968
+
969
+ it("should work with ctrl+k after undo", async () => {
970
+ const { textarea: editor } = await createTextareaRenderable(currentRenderer, renderOnce, {
971
+ initialValue: "Hello World",
972
+ width: 40,
973
+ height: 10,
974
+ keyBindings: [{ name: "u", action: "undo" }],
975
+ })
976
+
977
+ editor.focus()
978
+ for (let i = 0; i < 6; i++) {
979
+ editor.moveCursorRight()
980
+ }
981
+
982
+ currentMockInput.pressKey("k", { ctrl: true })
983
+ expect(editor.plainText).toBe("Hello ")
984
+
985
+ currentMockInput.pressKey("u")
986
+ expect(editor.plainText).toBe("Hello World")
987
+ expect(editor.logicalCursor.col).toBe(6)
988
+
989
+ currentMockInput.pressKey("k", { ctrl: true })
990
+ expect(editor.plainText).toBe("Hello ")
991
+ })
992
+
993
+ it("should work with ctrl+u after undo when cursor is repositioned", async () => {
994
+ const { textarea: editor } = await createTextareaRenderable(currentRenderer, renderOnce, {
995
+ initialValue: "Hello World",
996
+ width: 40,
997
+ height: 10,
998
+ keyBindings: [{ name: "z", action: "undo" }],
999
+ })
1000
+
1001
+ editor.focus()
1002
+ for (let i = 0; i < 6; i++) {
1003
+ editor.moveCursorRight()
1004
+ }
1005
+
1006
+ currentMockInput.pressKey("u", { ctrl: true })
1007
+ expect(editor.plainText).toBe("World")
1008
+ expect(editor.logicalCursor.col).toBe(0)
1009
+
1010
+ currentMockInput.pressKey("z")
1011
+ expect(editor.plainText).toBe("Hello World")
1012
+
1013
+ for (let i = 0; i < 6; i++) {
1014
+ editor.moveCursorRight()
1015
+ }
1016
+ expect(editor.logicalCursor.col).toBe(6)
1017
+
1018
+ currentMockInput.pressKey("u", { ctrl: true })
1019
+ expect(editor.plainText).toBe("World")
1020
+ })
1021
+
1022
+ it("should allow cursor to move right within restored line after undo", async () => {
1023
+ const { textarea: editor } = await createTextareaRenderable(currentRenderer, renderOnce, {
1024
+ initialValue: "Line 1 content\nLine 2 content\nLine 3 content",
1025
+ width: 40,
1026
+ height: 10,
1027
+ keyBindings: [{ name: "u", action: "undo" }],
1028
+ })
1029
+
1030
+ editor.focus()
1031
+ for (let i = 0; i < 7; i++) {
1032
+ editor.moveCursorRight()
1033
+ }
1034
+
1035
+ currentMockInput.pressKey("k", { ctrl: true })
1036
+ expect(editor.plainText).toBe("Line 1 \nLine 2 content\nLine 3 content")
1037
+
1038
+ currentMockInput.pressKey("u")
1039
+ expect(editor.plainText).toBe("Line 1 content\nLine 2 content\nLine 3 content")
1040
+
1041
+ for (let i = 0; i < 3; i++) {
1042
+ editor.moveCursorRight()
1043
+ }
1044
+
1045
+ expect(editor.logicalCursor.row).toBe(0)
1046
+ expect(editor.logicalCursor.col).toBe(10)
1047
+ })
1048
+
1049
+ it("should allow ctrl+k to work again after undo", async () => {
1050
+ const { textarea: editor } = await createTextareaRenderable(currentRenderer, renderOnce, {
1051
+ initialValue: "Line 1 content\nLine 2",
1052
+ width: 40,
1053
+ height: 10,
1054
+ keyBindings: [{ name: "u", action: "undo" }],
1055
+ })
1056
+
1057
+ editor.focus()
1058
+ for (let i = 0; i < 7; i++) {
1059
+ editor.moveCursorRight()
1060
+ }
1061
+
1062
+ currentMockInput.pressKey("k", { ctrl: true })
1063
+ expect(editor.plainText).toBe("Line 1 \nLine 2")
1064
+
1065
+ currentMockInput.pressKey("u")
1066
+ expect(editor.plainText).toBe("Line 1 content\nLine 2")
1067
+
1068
+ currentMockInput.pressKey("k", { ctrl: true })
1069
+ expect(editor.plainText).toBe("Line 1 \nLine 2")
1070
+ })
1071
+ })
1072
+
1073
+ describe("Wrapped Lines", () => {
1074
+ it("should delete to end of logical line with ctrl+k when wrapping enabled", async () => {
1075
+ const { textarea: editor } = await createTextareaRenderable(currentRenderer, renderOnce, {
1076
+ initialValue: "This is a very long line that will wrap when viewport is narrow\nLine 2 content",
1077
+ width: 20,
1078
+ height: 10,
1079
+ wrapMode: "word",
1080
+ })
1081
+
1082
+ editor.focus()
1083
+
1084
+ for (let i = 0; i < 30; i++) {
1085
+ editor.moveCursorRight()
1086
+ }
1087
+
1088
+ const visualCursor = editor.editorView.getVisualCursor()
1089
+ expect(visualCursor.logicalRow).toBe(0)
1090
+ expect(visualCursor.logicalCol).toBe(30)
1091
+
1092
+ currentMockInput.pressKey("k", { ctrl: true })
1093
+
1094
+ const lines = editor.plainText.split("\n")
1095
+ expect(lines[0]).toBe("This is a very long line that ")
1096
+ expect(lines[1]).toBe("Line 2 content")
1097
+ expect(editor.logicalCursor.row).toBe(0)
1098
+ expect(editor.logicalCursor.col).toBe(30)
1099
+ })
1100
+
1101
+ it("should delete from start of logical line with ctrl+u when wrapping enabled", async () => {
1102
+ const { textarea: editor } = await createTextareaRenderable(currentRenderer, renderOnce, {
1103
+ initialValue: "This is a very long line that will wrap when viewport is narrow\nLine 2 content",
1104
+ width: 20,
1105
+ height: 10,
1106
+ wrapMode: "word",
1107
+ })
1108
+
1109
+ editor.focus()
1110
+
1111
+ const originalLine0 = editor.plainText.split("\n")[0]
1112
+
1113
+ for (let i = 0; i < 30; i++) {
1114
+ editor.moveCursorRight()
1115
+ }
1116
+
1117
+ currentMockInput.pressKey("u", { ctrl: true })
1118
+
1119
+ const lines = editor.plainText.split("\n")
1120
+ expect(lines[0]).toBe(originalLine0.substring(30))
1121
+ expect(editor.logicalCursor.row).toBe(0)
1122
+ expect(editor.logicalCursor.col).toBe(0)
1123
+ })
1124
+
1125
+ it("should work on second logical line when wrapped", async () => {
1126
+ const { textarea: editor } = await createTextareaRenderable(currentRenderer, renderOnce, {
1127
+ initialValue: "Short line 1\nThis is another very long line that will wrap\nLine 3",
1128
+ width: 20,
1129
+ height: 10,
1130
+ wrapMode: "word",
1131
+ })
1132
+
1133
+ editor.focus()
1134
+ editor.gotoLine(1)
1135
+
1136
+ const line1Before = editor.plainText.split("\n")[1]
1137
+
1138
+ for (let i = 0; i < 25; i++) {
1139
+ editor.moveCursorRight()
1140
+ }
1141
+
1142
+ currentMockInput.pressKey("k", { ctrl: true })
1143
+
1144
+ const lines = editor.plainText.split("\n")
1145
+ expect(lines[0]).toBe("Short line 1")
1146
+ expect(lines[1]).toBe(line1Before.substring(0, 25))
1147
+ expect(lines[2]).toBe("Line 3")
1148
+ })
1149
+
1150
+ it("should work after undo with wrapped lines", async () => {
1151
+ const { textarea: editor } = await createTextareaRenderable(currentRenderer, renderOnce, {
1152
+ initialValue: "This is a very long line that will wrap\nLine 2",
1153
+ width: 15,
1154
+ height: 10,
1155
+ wrapMode: "word",
1156
+ keyBindings: [{ name: "z", action: "undo" }],
1157
+ })
1158
+
1159
+ editor.focus()
1160
+
1161
+ for (let i = 0; i < 20; i++) {
1162
+ editor.moveCursorRight()
1163
+ }
1164
+
1165
+ currentMockInput.pressKey("k", { ctrl: true })
1166
+
1167
+ const afterDelete = editor.plainText.split("\n")[0]
1168
+ expect(afterDelete.length).toBe(20)
1169
+
1170
+ currentMockInput.pressKey("z")
1171
+
1172
+ const afterUndo = editor.plainText.split("\n")[0]
1173
+ expect(afterUndo.length).toBe(39)
1174
+
1175
+ currentMockInput.pressKey("k", { ctrl: true })
1176
+
1177
+ const afterSecondDelete = editor.plainText.split("\n")[0]
1178
+ expect(afterSecondDelete.length).toBe(20)
1179
+ })
1180
+
1181
+ it("should handle ctrl+k at exact wrap boundary", async () => {
1182
+ const { textarea: editor } = await createTextareaRenderable(currentRenderer, renderOnce, {
1183
+ initialValue: "AAAAAAAAAABBBBBBBBBBCCCCCCCCCC\nLine 2",
1184
+ width: 10,
1185
+ height: 10,
1186
+ wrapMode: "char",
1187
+ })
1188
+
1189
+ editor.focus()
1190
+
1191
+ for (let i = 0; i < 10; i++) {
1192
+ editor.moveCursorRight()
1193
+ }
1194
+
1195
+ const visualCursor = editor.editorView.getVisualCursor()
1196
+ expect(visualCursor.visualRow).toBe(1)
1197
+ expect(visualCursor.logicalCol).toBe(10)
1198
+
1199
+ currentMockInput.pressKey("k", { ctrl: true })
1200
+
1201
+ const lines = editor.plainText.split("\n")
1202
+ expect(lines[0]).toBe("AAAAAAAAAA")
1203
+ expect(lines[1]).toBe("Line 2")
1204
+ })
1205
+
1206
+ it("should handle ctrl+u on second visual line of first logical line", async () => {
1207
+ const { textarea: editor } = await createTextareaRenderable(currentRenderer, renderOnce, {
1208
+ initialValue: "AAAAAAAAAABBBBBBBBBBCCCCCCCCCC\nLine 2",
1209
+ width: 10,
1210
+ height: 10,
1211
+ wrapMode: "char",
1212
+ })
1213
+
1214
+ editor.focus()
1215
+
1216
+ for (let i = 0; i < 15; i++) {
1217
+ editor.moveCursorRight()
1218
+ }
1219
+
1220
+ const visualCursor = editor.editorView.getVisualCursor()
1221
+ expect(visualCursor.visualRow).toBe(1)
1222
+ expect(visualCursor.logicalRow).toBe(0)
1223
+ expect(visualCursor.logicalCol).toBe(15)
1224
+
1225
+ currentMockInput.pressKey("u", { ctrl: true })
1226
+
1227
+ const lines = editor.plainText.split("\n")
1228
+ expect(lines[0]).toBe("BBBBBCCCCCCCCCC")
1229
+ expect(lines[0].length).toBe(15)
1230
+ expect(editor.logicalCursor.col).toBe(0)
1231
+ })
1232
+ })
1233
+
1234
+ describe("Wrapped Lines", () => {
1235
+ it("should delete to end of logical line with ctrl+k when wrapping enabled", async () => {
1236
+ const { textarea: editor } = await createTextareaRenderable(currentRenderer, renderOnce, {
1237
+ initialValue: "This is a very long line that will wrap when viewport is narrow\nLine 2 content",
1238
+ width: 20,
1239
+ height: 10,
1240
+ wrapMode: "word",
1241
+ })
1242
+
1243
+ editor.focus()
1244
+
1245
+ for (let i = 0; i < 30; i++) {
1246
+ editor.moveCursorRight()
1247
+ }
1248
+
1249
+ const visualCursor = editor.editorView.getVisualCursor()
1250
+ expect(visualCursor.logicalRow).toBe(0)
1251
+ expect(visualCursor.logicalCol).toBe(30)
1252
+
1253
+ currentMockInput.pressKey("k", { ctrl: true })
1254
+
1255
+ const lines = editor.plainText.split("\n")
1256
+ expect(lines[0]).toBe("This is a very long line that ")
1257
+ expect(lines[1]).toBe("Line 2 content")
1258
+ expect(editor.logicalCursor.row).toBe(0)
1259
+ expect(editor.logicalCursor.col).toBe(30)
1260
+ })
1261
+
1262
+ it("should delete from start of logical line with ctrl+u when wrapping enabled", async () => {
1263
+ const { textarea: editor } = await createTextareaRenderable(currentRenderer, renderOnce, {
1264
+ initialValue: "This is a very long line that will wrap when viewport is narrow\nLine 2 content",
1265
+ width: 20,
1266
+ height: 10,
1267
+ wrapMode: "word",
1268
+ })
1269
+
1270
+ editor.focus()
1271
+
1272
+ const originalLine0 = editor.plainText.split("\n")[0]
1273
+
1274
+ for (let i = 0; i < 30; i++) {
1275
+ editor.moveCursorRight()
1276
+ }
1277
+
1278
+ currentMockInput.pressKey("u", { ctrl: true })
1279
+
1280
+ const lines = editor.plainText.split("\n")
1281
+ expect(lines[0]).toBe(originalLine0.substring(30))
1282
+ expect(editor.logicalCursor.row).toBe(0)
1283
+ expect(editor.logicalCursor.col).toBe(0)
1284
+ })
1285
+
1286
+ it("should work on second logical line when wrapped", async () => {
1287
+ const { textarea: editor } = await createTextareaRenderable(currentRenderer, renderOnce, {
1288
+ initialValue: "Short line 1\nThis is another very long line that will wrap\nLine 3",
1289
+ width: 20,
1290
+ height: 10,
1291
+ wrapMode: "word",
1292
+ })
1293
+
1294
+ editor.focus()
1295
+ editor.gotoLine(1)
1296
+
1297
+ const line1Before = editor.plainText.split("\n")[1]
1298
+
1299
+ for (let i = 0; i < 25; i++) {
1300
+ editor.moveCursorRight()
1301
+ }
1302
+
1303
+ currentMockInput.pressKey("k", { ctrl: true })
1304
+
1305
+ const lines = editor.plainText.split("\n")
1306
+ expect(lines[0]).toBe("Short line 1")
1307
+ expect(lines[1]).toBe(line1Before.substring(0, 25))
1308
+ expect(lines[2]).toBe("Line 3")
1309
+ })
1310
+
1311
+ it("should work after undo with wrapped lines", async () => {
1312
+ const { textarea: editor } = await createTextareaRenderable(currentRenderer, renderOnce, {
1313
+ initialValue: "This is a very long line that will wrap\nLine 2",
1314
+ width: 15,
1315
+ height: 10,
1316
+ wrapMode: "word",
1317
+ keyBindings: [{ name: "z", action: "undo" }],
1318
+ })
1319
+
1320
+ editor.focus()
1321
+
1322
+ for (let i = 0; i < 20; i++) {
1323
+ editor.moveCursorRight()
1324
+ }
1325
+
1326
+ currentMockInput.pressKey("k", { ctrl: true })
1327
+
1328
+ const afterDelete = editor.plainText.split("\n")[0]
1329
+ expect(afterDelete.length).toBe(20)
1330
+
1331
+ currentMockInput.pressKey("z")
1332
+
1333
+ const afterUndo = editor.plainText.split("\n")[0]
1334
+ expect(afterUndo.length).toBe(39)
1335
+
1336
+ currentMockInput.pressKey("k", { ctrl: true })
1337
+
1338
+ const afterSecondDelete = editor.plainText.split("\n")[0]
1339
+ expect(afterSecondDelete.length).toBe(20)
1340
+ })
1341
+
1342
+ it("should handle ctrl+k at exact wrap boundary", async () => {
1343
+ const { textarea: editor } = await createTextareaRenderable(currentRenderer, renderOnce, {
1344
+ initialValue: "AAAAAAAAAABBBBBBBBBBCCCCCCCCCC\nLine 2",
1345
+ width: 10,
1346
+ height: 10,
1347
+ wrapMode: "char",
1348
+ })
1349
+
1350
+ editor.focus()
1351
+
1352
+ for (let i = 0; i < 10; i++) {
1353
+ editor.moveCursorRight()
1354
+ }
1355
+
1356
+ const visualCursor = editor.editorView.getVisualCursor()
1357
+ expect(visualCursor.visualRow).toBe(1)
1358
+ expect(visualCursor.logicalCol).toBe(10)
1359
+
1360
+ currentMockInput.pressKey("k", { ctrl: true })
1361
+
1362
+ const lines = editor.plainText.split("\n")
1363
+ expect(lines[0]).toBe("AAAAAAAAAA")
1364
+ expect(lines[1]).toBe("Line 2")
1365
+ })
1366
+
1367
+ it("should handle ctrl+u on second visual line of first logical line", async () => {
1368
+ const { textarea: editor } = await createTextareaRenderable(currentRenderer, renderOnce, {
1369
+ initialValue: "AAAAAAAAAABBBBBBBBBBCCCCCCCCCC\nLine 2",
1370
+ width: 10,
1371
+ height: 10,
1372
+ wrapMode: "char",
1373
+ })
1374
+
1375
+ editor.focus()
1376
+
1377
+ for (let i = 0; i < 15; i++) {
1378
+ editor.moveCursorRight()
1379
+ }
1380
+
1381
+ const visualCursor = editor.editorView.getVisualCursor()
1382
+ expect(visualCursor.visualRow).toBe(1)
1383
+ expect(visualCursor.logicalRow).toBe(0)
1384
+ expect(visualCursor.logicalCol).toBe(15)
1385
+
1386
+ currentMockInput.pressKey("u", { ctrl: true })
1387
+
1388
+ const lines = editor.plainText.split("\n")
1389
+ expect(lines[0]).toBe("BBBBBCCCCCCCCCC")
1390
+ expect(lines[0].length).toBe(15)
1391
+ expect(editor.logicalCursor.col).toBe(0)
1392
+ })
1393
+ })
1394
+
1395
+ describe("Key Bindings", () => {
1396
+ it("should use default keybindings", async () => {
1397
+ const { textarea: editor } = await createTextareaRenderable(currentRenderer, renderOnce, {
1398
+ initialValue: "Line 1\nLine 2\nLine 3",
1399
+ width: 40,
1400
+ height: 10,
1401
+ keyBindings: [
1402
+ { name: "g", action: "buffer-home" },
1403
+ { name: "b", action: "buffer-end" },
1404
+ ],
1405
+ })
1406
+
1407
+ editor.focus()
1408
+ editor.gotoLine(9999)
1409
+ expect(editor.logicalCursor.row).toBe(2)
1410
+
1411
+ currentMockInput.pressKey("g")
1412
+ expect(editor.logicalCursor.row).toBe(0)
1413
+ expect(editor.logicalCursor.col).toBe(0)
1414
+
1415
+ currentMockInput.pressKey("b")
1416
+ expect(editor.logicalCursor.row).toBe(2)
1417
+ })
1418
+
1419
+ it("should map select-up and select-down to custom keys", async () => {
1420
+ const { textarea: editor } = await createTextareaRenderable(currentRenderer, renderOnce, {
1421
+ initialValue: "Line 1\nLine 2\nLine 3",
1422
+ width: 40,
1423
+ height: 10,
1424
+ selectable: true,
1425
+ keyBindings: [
1426
+ { name: "k", shift: true, action: "select-up" },
1427
+ { name: "j", shift: true, action: "select-down" },
1428
+ ],
1429
+ })
1430
+
1431
+ editor.focus()
1432
+ editor.gotoLine(1)
1433
+
1434
+ currentMockInput.pressKey("J", { shift: true })
1435
+ expect(editor.hasSelection()).toBe(true)
1436
+ const selectedText = editor.getSelectedText()
1437
+ expect(selectedText.includes("Line")).toBe(true)
1438
+ })
1439
+
1440
+ it("should preserve default keybindings when custom bindings don't override them", async () => {
1441
+ const { textarea: editor } = await createTextareaRenderable(currentRenderer, renderOnce, {
1442
+ initialValue: "Hello World",
1443
+ width: 40,
1444
+ height: 10,
1445
+ keyBindings: [{ name: "j", action: "move-down" }],
1446
+ })
1447
+
1448
+ editor.focus()
1449
+
1450
+ currentMockInput.pressArrow("right")
1451
+ expect(editor.logicalCursor.col).toBe(1)
1452
+
1453
+ currentMockInput.pressKey("HOME")
1454
+ expect(editor.logicalCursor.col).toBe(0)
1455
+ })
1456
+
1457
+ it("should allow remapping default keys to different actions", async () => {
1458
+ const { textarea: editor } = await createTextareaRenderable(currentRenderer, renderOnce, {
1459
+ initialValue: "Line 1\nLine 2\nLine 3",
1460
+ width: 40,
1461
+ height: 10,
1462
+ keyBindings: [{ name: "up", action: "buffer-home" }],
1463
+ })
1464
+
1465
+ editor.focus()
1466
+ editor.gotoLine(2)
1467
+
1468
+ currentMockInput.pressArrow("up")
1469
+ expect(editor.logicalCursor.row).toBe(0)
1470
+ expect(editor.logicalCursor.col).toBe(0)
1471
+ })
1472
+
1473
+ it("should handle complex keybinding scenario with multiple custom mappings", async () => {
1474
+ const { textarea: editor } = await createTextareaRenderable(currentRenderer, renderOnce, {
1475
+ initialValue: "Line 1\nLine 2\nLine 3",
1476
+ width: 40,
1477
+ height: 10,
1478
+ keyBindings: [
1479
+ { name: "h", action: "move-left" },
1480
+ { name: "j", action: "move-down" },
1481
+ { name: "k", action: "move-up" },
1482
+ { name: "l", action: "move-right" },
1483
+ { name: "i", action: "buffer-home" },
1484
+ { name: "a", action: "line-end" },
1485
+ ],
1486
+ })
1487
+
1488
+ editor.focus()
1489
+
1490
+ currentMockInput.pressKey("i")
1491
+ expect(editor.logicalCursor.row).toBe(0)
1492
+ expect(editor.logicalCursor.col).toBe(0)
1493
+
1494
+ currentMockInput.pressKey("a")
1495
+ expect(editor.logicalCursor.col).toBe(6)
1496
+
1497
+ currentMockInput.pressKey("h")
1498
+ expect(editor.logicalCursor.col).toBe(5)
1499
+
1500
+ currentMockInput.pressKey("j")
1501
+ expect(editor.logicalCursor.row).toBe(1)
1502
+
1503
+ currentMockInput.pressKey("k")
1504
+ expect(editor.logicalCursor.row).toBe(0)
1505
+
1506
+ currentMockInput.pressKey("l")
1507
+ expect(editor.logicalCursor.col).toBe(6)
1508
+ })
1509
+
1510
+ it("should not insert text when key is bound to action", async () => {
1511
+ const { textarea: editor } = await createTextareaRenderable(currentRenderer, renderOnce, {
1512
+ initialValue: "Hello",
1513
+ width: 40,
1514
+ height: 10,
1515
+ keyBindings: [{ name: "x", action: "delete" }],
1516
+ })
1517
+
1518
+ editor.focus()
1519
+
1520
+ currentMockInput.pressKey("x")
1521
+ expect(editor.plainText).toBe("ello")
1522
+
1523
+ expect(editor.plainText).not.toContain("x")
1524
+ })
1525
+
1526
+ it("should still insert unbound keys as text", async () => {
1527
+ const { textarea: editor } = await createTextareaRenderable(currentRenderer, renderOnce, {
1528
+ initialValue: "",
1529
+ width: 40,
1530
+ height: 10,
1531
+ keyBindings: [{ name: "j", action: "move-down" }],
1532
+ })
1533
+
1534
+ editor.focus()
1535
+
1536
+ currentMockInput.pressKey("h")
1537
+ expect(editor.plainText).toBe("h")
1538
+
1539
+ currentMockInput.pressKey("i")
1540
+ expect(editor.plainText).toBe("hi")
1541
+
1542
+ currentMockInput.pressKey("j")
1543
+ expect(editor.plainText).toBe("hi")
1544
+ })
1545
+
1546
+ it("should differentiate between key with and without modifiers", async () => {
1547
+ const { textarea: editor } = await createTextareaRenderable(currentRenderer, renderOnce, {
1548
+ initialValue: "Hello",
1549
+ width: 40,
1550
+ height: 10,
1551
+ keyBindings: [
1552
+ { name: "d", action: "delete" },
1553
+ { name: "d", meta: true, action: "delete-line" },
1554
+ ],
1555
+ })
1556
+
1557
+ editor.focus()
1558
+
1559
+ currentMockInput.pressKey("d")
1560
+ expect(editor.plainText).toBe("ello")
1561
+ })
1562
+
1563
+ it("should support selection actions with custom keybindings", async () => {
1564
+ const { textarea: editor } = await createTextareaRenderable(currentRenderer, renderOnce, {
1565
+ initialValue: "Hello World",
1566
+ width: 40,
1567
+ height: 10,
1568
+ selectable: true,
1569
+ keyBindings: [
1570
+ { name: "h", shift: true, action: "select-left" },
1571
+ { name: "l", shift: true, action: "select-right" },
1572
+ ],
1573
+ })
1574
+
1575
+ editor.focus()
1576
+ editor.gotoLine(9999)
1577
+
1578
+ currentMockInput.pressKey("H", { shift: true })
1579
+ expect(editor.hasSelection()).toBe(true)
1580
+ expect(editor.getSelectedText()).toBe("d")
1581
+
1582
+ currentMockInput.pressKey("H", { shift: true })
1583
+ expect(editor.getSelectedText()).toBe("ld")
1584
+
1585
+ currentMockInput.pressKey("L", { shift: true })
1586
+ expect(editor.getSelectedText()).toBe("d")
1587
+ })
1588
+
1589
+ it("should execute correct action when multiple keys map to different actions with same base", async () => {
1590
+ const { textarea: editor } = await createTextareaRenderable(currentRenderer, renderOnce, {
1591
+ initialValue: "Line 1\nLine 2",
1592
+ width: 40,
1593
+ height: 10,
1594
+ keyBindings: [
1595
+ { name: "j", action: "move-down" },
1596
+ { name: "j", ctrl: true, action: "buffer-end" },
1597
+ ],
1598
+ })
1599
+
1600
+ editor.focus()
1601
+
1602
+ currentMockInput.pressKey("j")
1603
+ expect(editor.logicalCursor.row).toBe(1)
1604
+
1605
+ editor.gotoLine(0)
1606
+ currentMockInput.pressKey("j", { ctrl: true })
1607
+ expect(editor.logicalCursor.row).toBe(1)
1608
+ })
1609
+
1610
+ it("should handle all action types via custom keybindings", async () => {
1611
+ const { textarea: editor } = await createTextareaRenderable(currentRenderer, renderOnce, {
1612
+ initialValue: "Line 1\nLine 2\nLine 3",
1613
+ width: 40,
1614
+ height: 10,
1615
+ selectable: true,
1616
+ keyBindings: [
1617
+ { name: "1", action: "move-left" },
1618
+ { name: "2", action: "move-right" },
1619
+ { name: "3", action: "move-up" },
1620
+ { name: "4", action: "move-down" },
1621
+ { name: "5", shift: true, action: "select-left" },
1622
+ { name: "6", shift: true, action: "select-right" },
1623
+ { name: "7", shift: true, action: "select-up" },
1624
+ { name: "8", shift: true, action: "select-down" },
1625
+ { name: "a", action: "line-home" },
1626
+ { name: "b", action: "line-end" },
1627
+ { name: "c", shift: true, action: "select-line-home" },
1628
+ { name: "d", shift: true, action: "select-line-end" },
1629
+ { name: "e", action: "buffer-home" },
1630
+ { name: "f", action: "buffer-end" },
1631
+ { name: "g", action: "delete-line" },
1632
+ { name: "h", action: "delete-to-line-end" },
1633
+ { name: "i", action: "backspace" },
1634
+ { name: "j", action: "delete" },
1635
+ { name: "k", action: "newline" },
1636
+ { name: "u", action: "undo" },
1637
+ { name: "r", action: "redo" },
1638
+ ],
1639
+ })
1640
+
1641
+ editor.focus()
1642
+ editor.gotoLine(1)
1643
+ editor.moveCursorRight()
1644
+ editor.moveCursorRight()
1645
+ expect(editor.logicalCursor.row).toBe(1)
1646
+ expect(editor.logicalCursor.col).toBe(2)
1647
+
1648
+ currentMockInput.pressKey("1")
1649
+ expect(editor.logicalCursor.col).toBe(1)
1650
+
1651
+ currentMockInput.pressKey("2")
1652
+ expect(editor.logicalCursor.col).toBe(2)
1653
+
1654
+ currentMockInput.pressKey("3")
1655
+ expect(editor.logicalCursor.row).toBe(0)
1656
+
1657
+ currentMockInput.pressKey("4")
1658
+ expect(editor.logicalCursor.row).toBe(1)
1659
+
1660
+ currentMockInput.pressKey("a")
1661
+ expect(editor.logicalCursor.col).toBe(0)
1662
+
1663
+ currentMockInput.pressKey("b")
1664
+ expect(editor.logicalCursor.col).toBe(6)
1665
+
1666
+ currentMockInput.pressKey("e")
1667
+ expect(editor.logicalCursor.row).toBe(0)
1668
+
1669
+ currentMockInput.pressKey("f")
1670
+ expect(editor.logicalCursor.row).toBe(2)
1671
+ })
1672
+
1673
+ it("should not break when empty keyBindings array is provided", async () => {
1674
+ const { textarea: editor } = await createTextareaRenderable(currentRenderer, renderOnce, {
1675
+ initialValue: "Hello",
1676
+ width: 40,
1677
+ height: 10,
1678
+ keyBindings: [],
1679
+ })
1680
+
1681
+ editor.focus()
1682
+
1683
+ currentMockInput.pressArrow("right")
1684
+ expect(editor.logicalCursor.col).toBe(1)
1685
+
1686
+ currentMockInput.pressKey("HOME")
1687
+ expect(editor.logicalCursor.col).toBe(0)
1688
+ })
1689
+
1690
+ it("should document limitation: bound character keys cannot be typed", async () => {
1691
+ const { textarea: editor } = await createTextareaRenderable(currentRenderer, renderOnce, {
1692
+ initialValue: "",
1693
+ width: 40,
1694
+ height: 10,
1695
+ keyBindings: [
1696
+ { name: "h", action: "move-left" },
1697
+ { name: "j", action: "move-down" },
1698
+ { name: "k", action: "move-up" },
1699
+ { name: "l", action: "move-right" },
1700
+ ],
1701
+ })
1702
+
1703
+ editor.focus()
1704
+
1705
+ currentMockInput.pressKey("h")
1706
+ currentMockInput.pressKey("e")
1707
+ currentMockInput.pressKey("l")
1708
+ currentMockInput.pressKey("l")
1709
+ currentMockInput.pressKey("o")
1710
+
1711
+ expect(editor.plainText).toBe("eo")
1712
+ })
1713
+
1714
+ it("should allow typing bound characters when using modifier keys for bindings", async () => {
1715
+ const { textarea: editor } = await createTextareaRenderable(currentRenderer, renderOnce, {
1716
+ initialValue: "",
1717
+ width: 40,
1718
+ height: 10,
1719
+ keyBindings: [
1720
+ { name: "h", ctrl: true, action: "move-left" },
1721
+ { name: "j", ctrl: true, action: "move-down" },
1722
+ { name: "k", ctrl: true, action: "move-up" },
1723
+ { name: "l", ctrl: true, action: "move-right" },
1724
+ ],
1725
+ })
1726
+
1727
+ editor.focus()
1728
+
1729
+ currentMockInput.pressKey("h")
1730
+ currentMockInput.pressKey("e")
1731
+ currentMockInput.pressKey("l")
1732
+ currentMockInput.pressKey("l")
1733
+ currentMockInput.pressKey("o")
1734
+
1735
+ expect(editor.plainText).toBe("hello")
1736
+
1737
+ currentMockInput.pressKey("h", { ctrl: true })
1738
+ expect(editor.logicalCursor.col).toBe(4)
1739
+ })
1740
+ })
1741
+
1742
+ describe("Default Word Deletion Keybindings", () => {
1743
+ it("should delete character forward with ctrl+d", async () => {
1744
+ const { textarea: editor } = await createTextareaRenderable(currentRenderer, renderOnce, {
1745
+ initialValue: "hello world test",
1746
+ width: 40,
1747
+ height: 10,
1748
+ })
1749
+
1750
+ editor.focus()
1751
+
1752
+ currentMockInput.pressKey("d", { ctrl: true })
1753
+ expect(editor.plainText).toBe("ello world test")
1754
+ expect(editor.logicalCursor.col).toBe(0)
1755
+
1756
+ currentMockInput.pressKey("d", { ctrl: true })
1757
+ expect(editor.plainText).toBe("llo world test")
1758
+ expect(editor.logicalCursor.col).toBe(0)
1759
+ })
1760
+
1761
+ it("should delete word backward with ctrl+w", async () => {
1762
+ const { textarea: editor } = await createTextareaRenderable(currentRenderer, renderOnce, {
1763
+ initialValue: "hello world test",
1764
+ width: 40,
1765
+ height: 10,
1766
+ })
1767
+
1768
+ editor.focus()
1769
+ editor.gotoLineEnd()
1770
+ expect(editor.logicalCursor.col).toBe(16)
1771
+
1772
+ currentMockInput.pressKey("w", { ctrl: true })
1773
+ expect(editor.plainText).toBe("hello world ")
1774
+ expect(editor.logicalCursor.col).toBe(12)
1775
+
1776
+ currentMockInput.pressKey("w", { ctrl: true })
1777
+ expect(editor.plainText).toBe("hello ")
1778
+ expect(editor.logicalCursor.col).toBe(6)
1779
+ })
1780
+
1781
+ it("should stop at CJK-ASCII boundary with ctrl+w", async () => {
1782
+ const { textarea: editor } = await createTextareaRenderable(currentRenderer, renderOnce, {
1783
+ initialValue: "日本語abc",
1784
+ width: 40,
1785
+ height: 10,
1786
+ })
1787
+
1788
+ editor.focus()
1789
+ editor.gotoLineEnd()
1790
+
1791
+ currentMockInput.pressKey("w", { ctrl: true })
1792
+ expect(editor.plainText).toBe("日本語")
1793
+
1794
+ currentMockInput.pressKey("w", { ctrl: true })
1795
+ expect(editor.plainText).toBe("")
1796
+ })
1797
+
1798
+ it("should keep Hangul run grouped with ctrl+w", async () => {
1799
+ const { textarea: editor } = await createTextareaRenderable(currentRenderer, renderOnce, {
1800
+ initialValue: "테스트test",
1801
+ width: 40,
1802
+ height: 10,
1803
+ })
1804
+
1805
+ editor.focus()
1806
+ editor.gotoLineEnd()
1807
+
1808
+ currentMockInput.pressKey("w", { ctrl: true })
1809
+ expect(editor.plainText).toBe("테스트")
1810
+
1811
+ currentMockInput.pressKey("w", { ctrl: true })
1812
+ expect(editor.plainText).toBe("")
1813
+ })
1814
+
1815
+ it("should stop at CJK punctuation before ASCII with ctrl+w", async () => {
1816
+ const { textarea: editor } = await createTextareaRenderable(currentRenderer, renderOnce, {
1817
+ initialValue: "日本語。abc",
1818
+ width: 40,
1819
+ height: 10,
1820
+ })
1821
+
1822
+ editor.focus()
1823
+ editor.gotoLineEnd()
1824
+
1825
+ currentMockInput.pressKey("w", { ctrl: true })
1826
+ expect(editor.plainText).toBe("日本語。")
1827
+
1828
+ currentMockInput.pressKey("w", { ctrl: true })
1829
+ expect(editor.plainText).toBe("")
1830
+ })
1831
+
1832
+ it("should stop at compat ideograph boundary with ctrl+w", async () => {
1833
+ const { textarea: editor } = await createTextareaRenderable(currentRenderer, renderOnce, {
1834
+ initialValue: "丽abc",
1835
+ width: 40,
1836
+ height: 10,
1837
+ })
1838
+
1839
+ editor.focus()
1840
+ editor.gotoLineEnd()
1841
+
1842
+ currentMockInput.pressKey("w", { ctrl: true })
1843
+ expect(editor.plainText).toBe("丽")
1844
+
1845
+ currentMockInput.pressKey("w", { ctrl: true })
1846
+ expect(editor.plainText).toBe("")
1847
+ })
1848
+
1849
+ it("should delete word forward with meta+d", async () => {
1850
+ const { textarea: editor } = await createTextareaRenderable(currentRenderer, renderOnce, {
1851
+ initialValue: "hello world test",
1852
+ width: 40,
1853
+ height: 10,
1854
+ })
1855
+
1856
+ editor.focus()
1857
+ expect(editor.logicalCursor.col).toBe(0)
1858
+
1859
+ currentMockInput.pressKey("d", { meta: true })
1860
+ expect(editor.plainText).toBe("world test")
1861
+ expect(editor.logicalCursor.col).toBe(0)
1862
+
1863
+ currentMockInput.pressKey("d", { meta: true })
1864
+ expect(editor.plainText).toBe("test")
1865
+ expect(editor.logicalCursor.col).toBe(0)
1866
+ })
1867
+
1868
+ it("should delete character forward from middle of word with ctrl+d", async () => {
1869
+ const { textarea: editor } = await createTextareaRenderable(currentRenderer, renderOnce, {
1870
+ initialValue: "hello world",
1871
+ width: 40,
1872
+ height: 10,
1873
+ })
1874
+
1875
+ editor.focus()
1876
+ for (let i = 0; i < 3; i++) {
1877
+ editor.moveCursorRight()
1878
+ }
1879
+ expect(editor.logicalCursor.col).toBe(3)
1880
+
1881
+ currentMockInput.pressKey("d", { ctrl: true })
1882
+ expect(editor.plainText).toBe("helo world")
1883
+ expect(editor.logicalCursor.col).toBe(3)
1884
+ })
1885
+
1886
+ it("should delete word backward from middle of word with ctrl+w", async () => {
1887
+ const { textarea: editor } = await createTextareaRenderable(currentRenderer, renderOnce, {
1888
+ initialValue: "hello world",
1889
+ width: 40,
1890
+ height: 10,
1891
+ })
1892
+
1893
+ editor.focus()
1894
+ for (let i = 0; i < 8; i++) {
1895
+ editor.moveCursorRight()
1896
+ }
1897
+ expect(editor.logicalCursor.col).toBe(8)
1898
+
1899
+ currentMockInput.pressKey("w", { ctrl: true })
1900
+ expect(editor.plainText).toBe("hello rld")
1901
+ expect(editor.logicalCursor.col).toBe(6)
1902
+ })
1903
+
1904
+ it("should delete word forward from middle of word with meta+d", async () => {
1905
+ const { textarea: editor } = await createTextareaRenderable(currentRenderer, renderOnce, {
1906
+ initialValue: "hello world",
1907
+ width: 40,
1908
+ height: 10,
1909
+ })
1910
+
1911
+ editor.focus()
1912
+ for (let i = 0; i < 3; i++) {
1913
+ editor.moveCursorRight()
1914
+ }
1915
+ expect(editor.logicalCursor.col).toBe(3)
1916
+
1917
+ currentMockInput.pressKey("d", { meta: true })
1918
+ expect(editor.plainText).toBe("helworld")
1919
+ expect(editor.logicalCursor.col).toBe(3)
1920
+ })
1921
+
1922
+ it("should delete word forward from space with meta+d", async () => {
1923
+ const { textarea: editor } = await createTextareaRenderable(currentRenderer, renderOnce, {
1924
+ initialValue: "hello world test",
1925
+ width: 40,
1926
+ height: 10,
1927
+ })
1928
+
1929
+ editor.focus()
1930
+ for (let i = 0; i < 5; i++) {
1931
+ editor.moveCursorRight()
1932
+ }
1933
+ expect(editor.logicalCursor.col).toBe(5)
1934
+
1935
+ currentMockInput.pressKey("d", { meta: true })
1936
+ expect(editor.plainText).toBe("hellotest")
1937
+ expect(editor.logicalCursor.col).toBe(5)
1938
+ })
1939
+
1940
+ it("should delete word forward with meta+delete", async () => {
1941
+ const { textarea: editor } = await createTextareaRenderable(currentRenderer, renderOnce, {
1942
+ initialValue: "hello world test",
1943
+ width: 40,
1944
+ height: 10,
1945
+ })
1946
+
1947
+ editor.focus()
1948
+ expect(editor.logicalCursor.col).toBe(0)
1949
+
1950
+ currentMockInput.pressKey("DELETE", { meta: true })
1951
+ expect(editor.plainText).toBe("world test")
1952
+ expect(editor.logicalCursor.col).toBe(0)
1953
+
1954
+ currentMockInput.pressKey("DELETE", { meta: true })
1955
+ expect(editor.plainText).toBe("test")
1956
+ expect(editor.logicalCursor.col).toBe(0)
1957
+ })
1958
+
1959
+ it("should delete word forward from middle of word with meta+delete", async () => {
1960
+ const { textarea: editor } = await createTextareaRenderable(currentRenderer, renderOnce, {
1961
+ initialValue: "hello world",
1962
+ width: 40,
1963
+ height: 10,
1964
+ })
1965
+
1966
+ editor.focus()
1967
+ for (let i = 0; i < 3; i++) {
1968
+ editor.moveCursorRight()
1969
+ }
1970
+ expect(editor.logicalCursor.col).toBe(3)
1971
+
1972
+ currentMockInput.pressKey("DELETE", { meta: true })
1973
+ expect(editor.plainText).toBe("helworld")
1974
+ expect(editor.logicalCursor.col).toBe(3)
1975
+ })
1976
+
1977
+ it("should delete word forward from space with meta+delete", async () => {
1978
+ const { textarea: editor } = await createTextareaRenderable(currentRenderer, renderOnce, {
1979
+ initialValue: "hello world test",
1980
+ width: 40,
1981
+ height: 10,
1982
+ })
1983
+
1984
+ editor.focus()
1985
+ for (let i = 0; i < 5; i++) {
1986
+ editor.moveCursorRight()
1987
+ }
1988
+ expect(editor.logicalCursor.col).toBe(5)
1989
+
1990
+ currentMockInput.pressKey("DELETE", { meta: true })
1991
+ expect(editor.plainText).toBe("hellotest")
1992
+ expect(editor.logicalCursor.col).toBe(5)
1993
+ })
1994
+
1995
+ it("should delete word forward with ctrl+delete", async () => {
1996
+ const { textarea: editor } = await createTextareaRenderable(currentRenderer, renderOnce, {
1997
+ initialValue: "hello world test",
1998
+ width: 40,
1999
+ height: 10,
2000
+ })
2001
+
2002
+ editor.focus()
2003
+ expect(editor.logicalCursor.col).toBe(0)
2004
+
2005
+ currentMockInput.pressKey("DELETE", { ctrl: true })
2006
+ expect(editor.plainText).toBe("world test")
2007
+ expect(editor.logicalCursor.col).toBe(0)
2008
+
2009
+ currentMockInput.pressKey("DELETE", { ctrl: true })
2010
+ expect(editor.plainText).toBe("test")
2011
+ expect(editor.logicalCursor.col).toBe(0)
2012
+ })
2013
+
2014
+ it("should delete word forward from middle of word with ctrl+delete", async () => {
2015
+ const { textarea: editor } = await createTextareaRenderable(currentRenderer, renderOnce, {
2016
+ initialValue: "hello world",
2017
+ width: 40,
2018
+ height: 10,
2019
+ })
2020
+
2021
+ editor.focus()
2022
+ for (let i = 0; i < 3; i++) {
2023
+ editor.moveCursorRight()
2024
+ }
2025
+ expect(editor.logicalCursor.col).toBe(3)
2026
+
2027
+ currentMockInput.pressKey("DELETE", { ctrl: true })
2028
+ expect(editor.plainText).toBe("helworld")
2029
+ expect(editor.logicalCursor.col).toBe(3)
2030
+ })
2031
+
2032
+ it("should delete word forward from space with ctrl+delete", async () => {
2033
+ const { textarea: editor } = await createTextareaRenderable(currentRenderer, renderOnce, {
2034
+ initialValue: "hello world test",
2035
+ width: 40,
2036
+ height: 10,
2037
+ })
2038
+
2039
+ editor.focus()
2040
+ for (let i = 0; i < 5; i++) {
2041
+ editor.moveCursorRight()
2042
+ }
2043
+ expect(editor.logicalCursor.col).toBe(5)
2044
+
2045
+ currentMockInput.pressKey("DELETE", { ctrl: true })
2046
+ expect(editor.plainText).toBe("hellotest")
2047
+ expect(editor.logicalCursor.col).toBe(5)
2048
+ })
2049
+
2050
+ it("should delete word backward with ctrl+backspace", async () => {
2051
+ const { textarea: editor } = await createTextareaRenderable(currentRenderer, renderOnce, {
2052
+ initialValue: "hello world test",
2053
+ width: 40,
2054
+ height: 10,
2055
+ })
2056
+
2057
+ editor.focus()
2058
+ editor.gotoLineEnd()
2059
+ expect(editor.logicalCursor.col).toBe(16)
2060
+
2061
+ currentMockInput.pressBackspace({ ctrl: true })
2062
+ expect(editor.plainText).toBe("hello world ")
2063
+ expect(editor.logicalCursor.col).toBe(12)
2064
+
2065
+ currentMockInput.pressBackspace({ ctrl: true })
2066
+ expect(editor.plainText).toBe("hello ")
2067
+ expect(editor.logicalCursor.col).toBe(6)
2068
+ })
2069
+
2070
+ it("should delete word backward from middle of word with ctrl+backspace", async () => {
2071
+ const { textarea: editor } = await createTextareaRenderable(currentRenderer, renderOnce, {
2072
+ initialValue: "hello world",
2073
+ width: 40,
2074
+ height: 10,
2075
+ })
2076
+
2077
+ editor.focus()
2078
+ for (let i = 0; i < 8; i++) {
2079
+ editor.moveCursorRight()
2080
+ }
2081
+ expect(editor.logicalCursor.col).toBe(8)
2082
+
2083
+ currentMockInput.pressBackspace({ ctrl: true })
2084
+ expect(editor.plainText).toBe("hello rld")
2085
+ expect(editor.logicalCursor.col).toBe(6)
2086
+ })
2087
+
2088
+ it("should delete word backward from space with ctrl+backspace", async () => {
2089
+ const { textarea: editor } = await createTextareaRenderable(currentRenderer, renderOnce, {
2090
+ initialValue: "hello world test",
2091
+ width: 40,
2092
+ height: 10,
2093
+ })
2094
+
2095
+ editor.focus()
2096
+ for (let i = 0; i < 6; i++) {
2097
+ editor.moveCursorRight()
2098
+ }
2099
+ expect(editor.logicalCursor.col).toBe(6)
2100
+
2101
+ currentMockInput.pressBackspace({ ctrl: true })
2102
+ expect(editor.plainText).toBe("world test")
2103
+ expect(editor.logicalCursor.col).toBe(0)
2104
+ })
2105
+
2106
+ it("should delete line with ctrl+shift+d (requires Kitty keyboard protocol)", async () => {
2107
+ const {
2108
+ renderer: kittyRenderer,
2109
+ renderOnce: kittyRenderOnce,
2110
+ mockInput: kittyMockInput,
2111
+ } = await createTestRenderer({
2112
+ width: 80,
2113
+ height: 24,
2114
+ kittyKeyboard: true,
2115
+ })
2116
+
2117
+ const { textarea: editor } = await createTextareaRenderable(kittyRenderer, kittyRenderOnce, {
2118
+ initialValue: "Line 1\nLine 2\nLine 3",
2119
+ width: 40,
2120
+ height: 10,
2121
+ })
2122
+
2123
+ editor.focus()
2124
+ editor.gotoLine(1)
2125
+ expect(editor.logicalCursor.row).toBe(1)
2126
+
2127
+ kittyMockInput.pressKey("d", { ctrl: true, shift: true })
2128
+ expect(editor.plainText).toBe("Line 1\nLine 3")
2129
+ expect(editor.logicalCursor.row).toBe(1)
2130
+
2131
+ kittyRenderer.destroy()
2132
+ })
2133
+
2134
+ it("should delete first line with ctrl+shift+d (requires Kitty keyboard protocol)", async () => {
2135
+ const {
2136
+ renderer: kittyRenderer,
2137
+ renderOnce: kittyRenderOnce,
2138
+ mockInput: kittyMockInput,
2139
+ } = await createTestRenderer({
2140
+ width: 80,
2141
+ height: 24,
2142
+ kittyKeyboard: true,
2143
+ })
2144
+
2145
+ const { textarea: editor } = await createTextareaRenderable(kittyRenderer, kittyRenderOnce, {
2146
+ initialValue: "Line 1\nLine 2\nLine 3",
2147
+ width: 40,
2148
+ height: 10,
2149
+ })
2150
+
2151
+ editor.focus()
2152
+ expect(editor.logicalCursor.row).toBe(0)
2153
+
2154
+ kittyMockInput.pressKey("d", { ctrl: true, shift: true })
2155
+ expect(editor.plainText).toBe("Line 2\nLine 3")
2156
+ expect(editor.logicalCursor.row).toBe(0)
2157
+
2158
+ kittyRenderer.destroy()
2159
+ })
2160
+
2161
+ it("should delete last line with ctrl+shift+d (requires Kitty keyboard protocol)", async () => {
2162
+ const {
2163
+ renderer: kittyRenderer,
2164
+ renderOnce: kittyRenderOnce,
2165
+ mockInput: kittyMockInput,
2166
+ } = await createTestRenderer({
2167
+ width: 80,
2168
+ height: 24,
2169
+ kittyKeyboard: true,
2170
+ })
2171
+
2172
+ const { textarea: editor } = await createTextareaRenderable(kittyRenderer, kittyRenderOnce, {
2173
+ initialValue: "Line 1\nLine 2\nLine 3",
2174
+ width: 40,
2175
+ height: 10,
2176
+ })
2177
+
2178
+ editor.focus()
2179
+ editor.gotoLine(2)
2180
+ expect(editor.logicalCursor.row).toBe(2)
2181
+
2182
+ kittyMockInput.pressKey("d", { ctrl: true, shift: true })
2183
+ expect(editor.plainText).toBe("Line 1\nLine 2")
2184
+ expect(editor.logicalCursor.row).toBe(1)
2185
+
2186
+ kittyRenderer.destroy()
2187
+ })
2188
+ })
2189
+
2190
+ describe("Default Character and Word Movement Keybindings", () => {
2191
+ it("should move forward one character with ctrl+f", async () => {
2192
+ const { textarea: editor } = await createTextareaRenderable(currentRenderer, renderOnce, {
2193
+ initialValue: "hello world",
2194
+ width: 40,
2195
+ height: 10,
2196
+ })
2197
+
2198
+ editor.focus()
2199
+ expect(editor.logicalCursor.col).toBe(0)
2200
+
2201
+ currentMockInput.pressKey("f", { ctrl: true })
2202
+ expect(editor.logicalCursor.col).toBe(1)
2203
+
2204
+ currentMockInput.pressKey("f", { ctrl: true })
2205
+ expect(editor.logicalCursor.col).toBe(2)
2206
+
2207
+ currentMockInput.pressKey("f", { ctrl: true })
2208
+ expect(editor.logicalCursor.col).toBe(3)
2209
+ })
2210
+
2211
+ it("should move backward one character with ctrl+b", async () => {
2212
+ const { textarea: editor } = await createTextareaRenderable(currentRenderer, renderOnce, {
2213
+ initialValue: "hello world",
2214
+ width: 40,
2215
+ height: 10,
2216
+ })
2217
+
2218
+ editor.focus()
2219
+ editor.gotoLineEnd()
2220
+ expect(editor.logicalCursor.col).toBe(11)
2221
+
2222
+ currentMockInput.pressKey("b", { ctrl: true })
2223
+ expect(editor.logicalCursor.col).toBe(10)
2224
+
2225
+ currentMockInput.pressKey("b", { ctrl: true })
2226
+ expect(editor.logicalCursor.col).toBe(9)
2227
+
2228
+ currentMockInput.pressKey("b", { ctrl: true })
2229
+ expect(editor.logicalCursor.col).toBe(8)
2230
+ })
2231
+
2232
+ it("should move forward one word with meta+f", async () => {
2233
+ const { textarea: editor } = await createTextareaRenderable(currentRenderer, renderOnce, {
2234
+ initialValue: "hello world test",
2235
+ width: 40,
2236
+ height: 10,
2237
+ })
2238
+
2239
+ editor.focus()
2240
+ expect(editor.logicalCursor.col).toBe(0)
2241
+
2242
+ currentMockInput.pressKey("f", { meta: true })
2243
+ expect(editor.logicalCursor.col).toBe(6)
2244
+
2245
+ currentMockInput.pressKey("f", { meta: true })
2246
+ expect(editor.logicalCursor.col).toBe(12)
2247
+
2248
+ currentMockInput.pressKey("f", { meta: true })
2249
+ expect(editor.logicalCursor.col).toBe(16)
2250
+ })
2251
+
2252
+ it("should move backward one word with meta+b", async () => {
2253
+ const { textarea: editor } = await createTextareaRenderable(currentRenderer, renderOnce, {
2254
+ initialValue: "hello world test",
2255
+ width: 40,
2256
+ height: 10,
2257
+ })
2258
+
2259
+ editor.focus()
2260
+ editor.gotoLineEnd()
2261
+ expect(editor.logicalCursor.col).toBe(16)
2262
+
2263
+ currentMockInput.pressKey("b", { meta: true })
2264
+ expect(editor.logicalCursor.col).toBe(12)
2265
+
2266
+ currentMockInput.pressKey("b", { meta: true })
2267
+ expect(editor.logicalCursor.col).toBe(6)
2268
+
2269
+ currentMockInput.pressKey("b", { meta: true })
2270
+ expect(editor.logicalCursor.col).toBe(0)
2271
+ })
2272
+
2273
+ it("should move forward one word with ctrl+right", async () => {
2274
+ const { textarea: editor } = await createTextareaRenderable(currentRenderer, renderOnce, {
2275
+ initialValue: "hello world test",
2276
+ width: 40,
2277
+ height: 10,
2278
+ })
2279
+
2280
+ editor.focus()
2281
+ expect(editor.logicalCursor.col).toBe(0)
2282
+
2283
+ currentMockInput.pressArrow("right", { ctrl: true })
2284
+ expect(editor.logicalCursor.col).toBe(6)
2285
+
2286
+ currentMockInput.pressArrow("right", { ctrl: true })
2287
+ expect(editor.logicalCursor.col).toBe(12)
2288
+
2289
+ currentMockInput.pressArrow("right", { ctrl: true })
2290
+ expect(editor.logicalCursor.col).toBe(16)
2291
+ })
2292
+
2293
+ it("should move backward one word with ctrl+left", async () => {
2294
+ const { textarea: editor } = await createTextareaRenderable(currentRenderer, renderOnce, {
2295
+ initialValue: "hello world test",
2296
+ width: 40,
2297
+ height: 10,
2298
+ })
2299
+
2300
+ editor.focus()
2301
+ editor.gotoLineEnd()
2302
+ expect(editor.logicalCursor.col).toBe(16)
2303
+
2304
+ currentMockInput.pressArrow("left", { ctrl: true })
2305
+ expect(editor.logicalCursor.col).toBe(12)
2306
+
2307
+ currentMockInput.pressArrow("left", { ctrl: true })
2308
+ expect(editor.logicalCursor.col).toBe(6)
2309
+
2310
+ currentMockInput.pressArrow("left", { ctrl: true })
2311
+ expect(editor.logicalCursor.col).toBe(0)
2312
+ })
2313
+
2314
+ it("should move across CJK-ASCII boundary with ctrl+right and ctrl+left", async () => {
2315
+ const { textarea: editor } = await createTextareaRenderable(currentRenderer, renderOnce, {
2316
+ initialValue: "日本語abc",
2317
+ width: 40,
2318
+ height: 10,
2319
+ })
2320
+
2321
+ editor.focus()
2322
+ expect(editor.logicalCursor.col).toBe(0)
2323
+
2324
+ currentMockInput.pressArrow("right", { ctrl: true })
2325
+ expect(editor.logicalCursor.col).toBe(6)
2326
+
2327
+ currentMockInput.pressArrow("right", { ctrl: true })
2328
+ expect(editor.logicalCursor.col).toBe(9)
2329
+
2330
+ currentMockInput.pressArrow("left", { ctrl: true })
2331
+ expect(editor.logicalCursor.col).toBe(6)
2332
+
2333
+ currentMockInput.pressArrow("left", { ctrl: true })
2334
+ expect(editor.logicalCursor.col).toBe(0)
2335
+ })
2336
+
2337
+ it("should move across CJK punctuation boundary with ctrl+right and ctrl+left", async () => {
2338
+ const { textarea: editor } = await createTextareaRenderable(currentRenderer, renderOnce, {
2339
+ initialValue: "日本語。abc",
2340
+ width: 40,
2341
+ height: 10,
2342
+ })
2343
+
2344
+ editor.focus()
2345
+ expect(editor.logicalCursor.col).toBe(0)
2346
+
2347
+ currentMockInput.pressArrow("right", { ctrl: true })
2348
+ expect(editor.logicalCursor.col).toBe(8)
2349
+
2350
+ currentMockInput.pressArrow("right", { ctrl: true })
2351
+ expect(editor.logicalCursor.col).toBe(11)
2352
+
2353
+ currentMockInput.pressArrow("left", { ctrl: true })
2354
+ expect(editor.logicalCursor.col).toBe(8)
2355
+
2356
+ currentMockInput.pressArrow("left", { ctrl: true })
2357
+ expect(editor.logicalCursor.col).toBe(0)
2358
+ })
2359
+
2360
+ it("should move across compat ideograph boundary with ctrl+right and ctrl+left", async () => {
2361
+ const { textarea: editor } = await createTextareaRenderable(currentRenderer, renderOnce, {
2362
+ initialValue: "丽abc",
2363
+ width: 40,
2364
+ height: 10,
2365
+ })
2366
+
2367
+ editor.focus()
2368
+ expect(editor.logicalCursor.col).toBe(0)
2369
+
2370
+ currentMockInput.pressArrow("right", { ctrl: true })
2371
+ expect(editor.logicalCursor.col).toBe(2)
2372
+
2373
+ currentMockInput.pressArrow("right", { ctrl: true })
2374
+ expect(editor.logicalCursor.col).toBe(5)
2375
+
2376
+ currentMockInput.pressArrow("left", { ctrl: true })
2377
+ expect(editor.logicalCursor.col).toBe(2)
2378
+
2379
+ currentMockInput.pressArrow("left", { ctrl: true })
2380
+ expect(editor.logicalCursor.col).toBe(0)
2381
+ })
2382
+
2383
+ it("should select words across CJK-ASCII boundary with meta+shift+arrows", async () => {
2384
+ const { textarea: editor } = await createTextareaRenderable(currentRenderer, renderOnce, {
2385
+ initialValue: "日本語abc",
2386
+ width: 40,
2387
+ height: 10,
2388
+ selectable: true,
2389
+ })
2390
+
2391
+ editor.focus()
2392
+
2393
+ currentMockInput.pressArrow("right", { meta: true, shift: true })
2394
+ expect(editor.logicalCursor.col).toBe(6)
2395
+ expect(editor.getSelectedText()).toBe("日本語")
2396
+
2397
+ currentMockInput.pressArrow("right", { meta: true, shift: true })
2398
+ expect(editor.logicalCursor.col).toBe(9)
2399
+ expect(editor.getSelectedText()).toBe("日本語abc")
2400
+
2401
+ currentMockInput.pressArrow("left", { meta: true, shift: true })
2402
+ expect(editor.logicalCursor.col).toBe(6)
2403
+ expect(editor.getSelectedText()).toBe("日本語")
2404
+
2405
+ currentMockInput.pressArrow("left", { meta: true, shift: true })
2406
+ expect(editor.logicalCursor.col).toBe(0)
2407
+ expect(editor.getSelectedText()).toBe("")
2408
+ })
2409
+
2410
+ it("should select words across compat ideograph boundary with meta+shift+arrows", async () => {
2411
+ const { textarea: editor } = await createTextareaRenderable(currentRenderer, renderOnce, {
2412
+ initialValue: "丽abc",
2413
+ width: 40,
2414
+ height: 10,
2415
+ selectable: true,
2416
+ })
2417
+
2418
+ editor.focus()
2419
+
2420
+ currentMockInput.pressArrow("right", { meta: true, shift: true })
2421
+ expect(editor.logicalCursor.col).toBe(2)
2422
+ expect(editor.getSelectedText()).toBe("丽")
2423
+
2424
+ currentMockInput.pressArrow("right", { meta: true, shift: true })
2425
+ expect(editor.logicalCursor.col).toBe(5)
2426
+ expect(editor.getSelectedText()).toBe("丽abc")
2427
+
2428
+ currentMockInput.pressArrow("left", { meta: true, shift: true })
2429
+ expect(editor.logicalCursor.col).toBe(2)
2430
+ expect(editor.getSelectedText()).toBe("丽")
2431
+
2432
+ currentMockInput.pressArrow("left", { meta: true, shift: true })
2433
+ expect(editor.logicalCursor.col).toBe(0)
2434
+ expect(editor.getSelectedText()).toBe("")
2435
+ })
2436
+
2437
+ it("should combine ctrl+left and ctrl+right for word navigation", async () => {
2438
+ const { textarea: editor } = await createTextareaRenderable(currentRenderer, renderOnce, {
2439
+ initialValue: "one two three four",
2440
+ width: 40,
2441
+ height: 10,
2442
+ })
2443
+
2444
+ editor.focus()
2445
+
2446
+ currentMockInput.pressArrow("right", { ctrl: true })
2447
+ expect(editor.logicalCursor.col).toBe(4)
2448
+
2449
+ currentMockInput.pressArrow("right", { ctrl: true })
2450
+ expect(editor.logicalCursor.col).toBe(8)
2451
+
2452
+ currentMockInput.pressArrow("left", { ctrl: true })
2453
+ expect(editor.logicalCursor.col).toBe(4)
2454
+
2455
+ currentMockInput.pressArrow("left", { ctrl: true })
2456
+ expect(editor.logicalCursor.col).toBe(0)
2457
+ })
2458
+
2459
+ it("should not insert 'f' when using ctrl+f for movement", async () => {
2460
+ const { textarea: editor } = await createTextareaRenderable(currentRenderer, renderOnce, {
2461
+ initialValue: "test",
2462
+ width: 40,
2463
+ height: 10,
2464
+ })
2465
+
2466
+ editor.focus()
2467
+ const before = editor.plainText
2468
+
2469
+ currentMockInput.pressKey("f", { ctrl: true })
2470
+ expect(editor.plainText).toBe(before)
2471
+ expect(editor.logicalCursor.col).toBe(1)
2472
+ })
2473
+
2474
+ it("should not insert 'b' when using ctrl+b for movement", async () => {
2475
+ const { textarea: editor } = await createTextareaRenderable(currentRenderer, renderOnce, {
2476
+ initialValue: "test",
2477
+ width: 40,
2478
+ height: 10,
2479
+ })
2480
+
2481
+ editor.focus()
2482
+ editor.gotoLineEnd()
2483
+ const before = editor.plainText
2484
+
2485
+ currentMockInput.pressKey("b", { ctrl: true })
2486
+ expect(editor.plainText).toBe(before)
2487
+ expect(editor.logicalCursor.col).toBe(3)
2488
+ })
2489
+
2490
+ it("should combine ctrl+f and ctrl+b for character navigation", async () => {
2491
+ const { textarea: editor } = await createTextareaRenderable(currentRenderer, renderOnce, {
2492
+ initialValue: "hello",
2493
+ width: 40,
2494
+ height: 10,
2495
+ })
2496
+
2497
+ editor.focus()
2498
+
2499
+ currentMockInput.pressKey("f", { ctrl: true })
2500
+ currentMockInput.pressKey("f", { ctrl: true })
2501
+ expect(editor.logicalCursor.col).toBe(2)
2502
+
2503
+ currentMockInput.pressKey("b", { ctrl: true })
2504
+ expect(editor.logicalCursor.col).toBe(1)
2505
+
2506
+ currentMockInput.pressKey("f", { ctrl: true })
2507
+ currentMockInput.pressKey("f", { ctrl: true })
2508
+ currentMockInput.pressKey("f", { ctrl: true })
2509
+ expect(editor.logicalCursor.col).toBe(4)
2510
+ })
2511
+
2512
+ it("should combine meta+f and meta+b for word navigation", async () => {
2513
+ const { textarea: editor } = await createTextareaRenderable(currentRenderer, renderOnce, {
2514
+ initialValue: "one two three four",
2515
+ width: 40,
2516
+ height: 10,
2517
+ })
2518
+
2519
+ editor.focus()
2520
+
2521
+ currentMockInput.pressKey("f", { meta: true })
2522
+ expect(editor.logicalCursor.col).toBe(4)
2523
+
2524
+ currentMockInput.pressKey("f", { meta: true })
2525
+ expect(editor.logicalCursor.col).toBe(8)
2526
+
2527
+ currentMockInput.pressKey("b", { meta: true })
2528
+ expect(editor.logicalCursor.col).toBe(4)
2529
+
2530
+ currentMockInput.pressKey("b", { meta: true })
2531
+ expect(editor.logicalCursor.col).toBe(0)
2532
+ })
2533
+ })
2534
+
2535
+ describe("Shift+Space Key Handling", () => {
2536
+ let modifierRenderer: TestRenderer
2537
+ let modifierRenderOnce: () => Promise<void>
2538
+ let modifierMockInput: MockInput
2539
+
2540
+ beforeEach(async () => {
2541
+ ;({
2542
+ renderer: modifierRenderer,
2543
+ renderOnce: modifierRenderOnce,
2544
+ mockInput: modifierMockInput,
2545
+ } = await createTestRenderer({
2546
+ width: 80,
2547
+ height: 24,
2548
+ otherModifiersMode: true,
2549
+ }))
2550
+ })
2551
+
2552
+ afterEach(() => {
2553
+ modifierRenderer.destroy()
2554
+ })
2555
+
2556
+ it("should insert a space when shift+space is pressed", async () => {
2557
+ const { textarea: editor } = await createTextareaRenderable(modifierRenderer, modifierRenderOnce, {
2558
+ initialValue: "",
2559
+ width: 40,
2560
+ height: 10,
2561
+ })
2562
+
2563
+ editor.focus()
2564
+
2565
+ // Type "hello"
2566
+ modifierMockInput.pressKey("h")
2567
+ modifierMockInput.pressKey("e")
2568
+ modifierMockInput.pressKey("l")
2569
+ modifierMockInput.pressKey("l")
2570
+ modifierMockInput.pressKey("o")
2571
+ expect(editor.plainText).toBe("hello")
2572
+
2573
+ // Press shift+space - should insert a space
2574
+ modifierMockInput.pressKey(" ", { shift: true })
2575
+ expect(editor.plainText).toBe("hello ")
2576
+ expect(editor.logicalCursor.col).toBe(6)
2577
+
2578
+ // Type "world"
2579
+ modifierMockInput.pressKey("w")
2580
+ modifierMockInput.pressKey("o")
2581
+ modifierMockInput.pressKey("r")
2582
+ modifierMockInput.pressKey("l")
2583
+ modifierMockInput.pressKey("d")
2584
+ expect(editor.plainText).toBe("hello world")
2585
+ })
2586
+
2587
+ it("should insert multiple spaces with shift+space", async () => {
2588
+ const { textarea: editor } = await createTextareaRenderable(modifierRenderer, modifierRenderOnce, {
2589
+ initialValue: "test",
2590
+ width: 40,
2591
+ height: 10,
2592
+ })
2593
+
2594
+ editor.focus()
2595
+ editor.gotoLineEnd()
2596
+
2597
+ modifierMockInput.pressKey(" ", { shift: true })
2598
+ modifierMockInput.pressKey(" ", { shift: true })
2599
+ modifierMockInput.pressKey(" ", { shift: true })
2600
+
2601
+ expect(editor.plainText).toBe("test ")
2602
+ expect(editor.logicalCursor.col).toBe(7)
2603
+ })
2604
+
2605
+ it("should insert space at middle of text with shift+space", async () => {
2606
+ const { textarea: editor } = await createTextareaRenderable(modifierRenderer, modifierRenderOnce, {
2607
+ initialValue: "helloworld",
2608
+ width: 40,
2609
+ height: 10,
2610
+ })
2611
+
2612
+ editor.focus()
2613
+ for (let i = 0; i < 5; i++) {
2614
+ editor.moveCursorRight()
2615
+ }
2616
+ expect(editor.logicalCursor.col).toBe(5)
2617
+
2618
+ modifierMockInput.pressKey(" ", { shift: true })
2619
+
2620
+ expect(editor.plainText).toBe("hello world")
2621
+ expect(editor.logicalCursor.col).toBe(6)
2622
+ })
2623
+ })
2624
+
2625
+ describe("Line Home/End Wrap Behavior", () => {
2626
+ it("should wrap to end of previous line when at start of line", async () => {
2627
+ const { textarea: editor } = await createTextareaRenderable(currentRenderer, renderOnce, {
2628
+ initialValue: "Line 1\nLine 2",
2629
+ width: 40,
2630
+ height: 10,
2631
+ })
2632
+ editor.focus()
2633
+ editor.gotoLine(1)
2634
+ expect(editor.logicalCursor).toMatchObject({ row: 1, col: 0 })
2635
+ editor.gotoLineHome()
2636
+ expect(editor.logicalCursor).toMatchObject({ row: 0, col: 6 })
2637
+ })
2638
+
2639
+ it("should wrap to start of next line when at end of line", async () => {
2640
+ const { textarea: editor } = await createTextareaRenderable(currentRenderer, renderOnce, {
2641
+ initialValue: "Line 1\nLine 2",
2642
+ width: 40,
2643
+ height: 10,
2644
+ })
2645
+ editor.focus()
2646
+ editor.gotoLineEnd()
2647
+ expect(editor.logicalCursor).toMatchObject({ row: 0, col: 6 })
2648
+ editor.gotoLineEnd()
2649
+ expect(editor.logicalCursor).toMatchObject({ row: 1, col: 0 })
2650
+ })
2651
+
2652
+ it("should stay at buffer boundaries", async () => {
2653
+ const { textarea: editor } = await createTextareaRenderable(currentRenderer, renderOnce, {
2654
+ initialValue: "Line 1\nLine 2",
2655
+ width: 40,
2656
+ height: 10,
2657
+ })
2658
+ editor.focus()
2659
+ editor.gotoLineHome()
2660
+ expect(editor.logicalCursor).toMatchObject({ row: 0, col: 0 })
2661
+ editor.gotoLine(1)
2662
+ editor.gotoLineEnd()
2663
+ editor.gotoLineEnd()
2664
+ expect(editor.logicalCursor).toMatchObject({ row: 1, col: 6 })
2665
+ })
2666
+ })
2667
+
2668
+ describe("Key Aliases", () => {
2669
+ it("should support binding 'enter' alias which maps to 'return'", async () => {
2670
+ const { textarea: editor } = await createTextareaRenderable(currentRenderer, renderOnce, {
2671
+ initialValue: "Hello",
2672
+ width: 40,
2673
+ height: 10,
2674
+ keyBindings: [{ name: "enter", action: "buffer-home" }],
2675
+ })
2676
+ editor.focus()
2677
+ editor.gotoLine(9999)
2678
+ // When user binds "enter", and "return" key is pressed (the actual Enter key)
2679
+ // it should work due to the default alias enter->return
2680
+ currentMockInput.pressEnter()
2681
+ expect(editor.logicalCursor.row).toBe(0)
2682
+ expect(editor.logicalCursor.col).toBe(0)
2683
+ })
2684
+
2685
+ it("should allow binding 'return' directly", async () => {
2686
+ const { textarea: editor } = await createTextareaRenderable(currentRenderer, renderOnce, {
2687
+ initialValue: "Hello",
2688
+ width: 40,
2689
+ height: 10,
2690
+ keyBindings: [{ name: "return", action: "buffer-home" }],
2691
+ })
2692
+ editor.focus()
2693
+ editor.gotoLine(9999)
2694
+ currentMockInput.pressEnter()
2695
+ expect(editor.logicalCursor.row).toBe(0)
2696
+ expect(editor.logicalCursor.col).toBe(0)
2697
+ })
2698
+
2699
+ it("should support custom aliases via keyAliasMap", async () => {
2700
+ const { textarea: editor } = await createTextareaRenderable(currentRenderer, renderOnce, {
2701
+ initialValue: "Line 1\nLine 2",
2702
+ width: 40,
2703
+ height: 10,
2704
+ keyBindings: [{ name: "myenter", action: "buffer-home" }],
2705
+ keyAliasMap: { myenter: "return" },
2706
+ })
2707
+ editor.focus()
2708
+ editor.gotoLine(9999)
2709
+ // Pressing Enter key (which comes in as "return") should trigger buffer-home
2710
+ // because "myenter" is aliased to "return"
2711
+ currentMockInput.pressEnter()
2712
+ expect(editor.logicalCursor.row).toBe(0)
2713
+ expect(editor.logicalCursor.col).toBe(0)
2714
+ })
2715
+
2716
+ it("should merge custom aliases with defaults", async () => {
2717
+ const { textarea: editor } = await createTextareaRenderable(currentRenderer, renderOnce, {
2718
+ initialValue: "Hello",
2719
+ width: 40,
2720
+ height: 10,
2721
+ keyBindings: [
2722
+ { name: "enter", action: "buffer-home" },
2723
+ { name: "customkey", action: "line-end" },
2724
+ ],
2725
+ keyAliasMap: { customkey: "e", enter: "return" },
2726
+ })
2727
+ editor.focus()
2728
+ // Default alias should still work (enter -> return)
2729
+ currentMockInput.pressEnter()
2730
+ expect(editor.logicalCursor.row).toBe(0)
2731
+ expect(editor.logicalCursor.col).toBe(0)
2732
+ // Custom alias should work (customkey -> e)
2733
+ currentMockInput.pressKey("e")
2734
+ expect(editor.logicalCursor.col).toBe(5)
2735
+ })
2736
+
2737
+ it("should update aliases dynamically with setter", async () => {
2738
+ const { textarea: editor } = await createTextareaRenderable(currentRenderer, renderOnce, {
2739
+ initialValue: "Line 1\nLine 2",
2740
+ width: 40,
2741
+ height: 10,
2742
+ keyBindings: [{ name: "mykey", action: "buffer-home" }],
2743
+ })
2744
+ editor.focus()
2745
+ editor.gotoLine(9999)
2746
+ expect(editor.logicalCursor.row).toBe(1)
2747
+ // Initially "mykey" doesn't map to "return", so Enter won't trigger buffer-home
2748
+ currentMockInput.pressEnter()
2749
+ expect(editor.plainText).toBe("Line 1\nLine 2\n") // newline was inserted
2750
+ // Set alias to map "mykey" to "return"
2751
+ editor.keyAliasMap = { mykey: "return" }
2752
+ // Now remove the newline we just added
2753
+ editor.deleteCharBackward()
2754
+ // Now pressing Enter should trigger buffer-home
2755
+ currentMockInput.pressEnter()
2756
+ expect(editor.logicalCursor.row).toBe(0)
2757
+ expect(editor.logicalCursor.col).toBe(0)
2758
+ })
2759
+
2760
+ it("should handle aliases with modifiers", async () => {
2761
+ const { textarea: editor } = await createTextareaRenderable(currentRenderer, renderOnce, {
2762
+ initialValue: "Line 1\nLine 2",
2763
+ width: 40,
2764
+ height: 10,
2765
+ keyBindings: [{ name: "enter", meta: true, action: "buffer-home" }],
2766
+ })
2767
+ editor.focus()
2768
+ editor.gotoLine(9999)
2769
+ expect(editor.logicalCursor.row).toBe(1)
2770
+ // Meta+Enter should trigger buffer-home due to alias (enter -> return)
2771
+ currentMockInput.pressEnter({ meta: true })
2772
+ expect(editor.logicalCursor.row).toBe(0)
2773
+ expect(editor.logicalCursor.col).toBe(0)
2774
+ })
2775
+ })
2776
+
2777
+ describe("Selection with ctrl+shift+a/e (line home/end)", () => {
2778
+ let kittyRenderer: TestRenderer
2779
+ let kittyRenderOnce: () => Promise<void>
2780
+ let kittyMockInput: MockInput
2781
+
2782
+ beforeEach(async () => {
2783
+ ;({
2784
+ renderer: kittyRenderer,
2785
+ renderOnce: kittyRenderOnce,
2786
+ mockInput: kittyMockInput,
2787
+ } = await createTestRenderer({
2788
+ width: 80,
2789
+ height: 24,
2790
+ kittyKeyboard: true,
2791
+ }))
2792
+ })
2793
+
2794
+ afterEach(() => {
2795
+ kittyRenderer.destroy()
2796
+ })
2797
+
2798
+ it("should select to line start with ctrl+shift+a", async () => {
2799
+ const { textarea: editor } = await createTextareaRenderable(kittyRenderer, kittyRenderOnce, {
2800
+ initialValue: "Hello World",
2801
+ width: 40,
2802
+ height: 10,
2803
+ })
2804
+
2805
+ editor.focus()
2806
+ editor.editBuffer.setCursor(0, 11) // End of line
2807
+
2808
+ kittyMockInput.pressKey("a", { ctrl: true, shift: true })
2809
+
2810
+ expect(editor.hasSelection()).toBe(true)
2811
+ const selection = editor.getSelection()
2812
+ expect(selection).not.toBeNull()
2813
+ expect(selection!.start).toBe(0)
2814
+ expect(selection!.end).toBe(11)
2815
+ expect(editor.getSelectedText()).toBe("Hello World")
2816
+ })
2817
+
2818
+ it("should select to line end with ctrl+shift+e", async () => {
2819
+ const { textarea: editor } = await createTextareaRenderable(kittyRenderer, kittyRenderOnce, {
2820
+ initialValue: "Hello World",
2821
+ width: 40,
2822
+ height: 10,
2823
+ })
2824
+
2825
+ editor.focus()
2826
+ editor.editBuffer.setCursor(0, 0) // Start of line
2827
+
2828
+ kittyMockInput.pressKey("e", { ctrl: true, shift: true })
2829
+
2830
+ expect(editor.hasSelection()).toBe(true)
2831
+ const selection = editor.getSelection()
2832
+ expect(selection).not.toBeNull()
2833
+ expect(selection!.start).toBe(0)
2834
+ expect(selection!.end).toBe(11)
2835
+ expect(editor.getSelectedText()).toBe("Hello World")
2836
+ })
2837
+
2838
+ it("should select to line start from middle with ctrl+shift+a", async () => {
2839
+ const { textarea: editor } = await createTextareaRenderable(kittyRenderer, kittyRenderOnce, {
2840
+ initialValue: "Hello World",
2841
+ width: 40,
2842
+ height: 10,
2843
+ })
2844
+
2845
+ editor.focus()
2846
+ editor.editBuffer.setCursor(0, 6) // After "Hello "
2847
+
2848
+ kittyMockInput.pressKey("a", { ctrl: true, shift: true })
2849
+
2850
+ expect(editor.hasSelection()).toBe(true)
2851
+ expect(editor.getSelectedText()).toBe("Hello W")
2852
+ })
2853
+
2854
+ it("should select to line end from middle with ctrl+shift+e", async () => {
2855
+ const { textarea: editor } = await createTextareaRenderable(kittyRenderer, kittyRenderOnce, {
2856
+ initialValue: "Hello World",
2857
+ width: 40,
2858
+ height: 10,
2859
+ })
2860
+
2861
+ editor.focus()
2862
+ editor.editBuffer.setCursor(0, 6) // After "Hello "
2863
+
2864
+ kittyMockInput.pressKey("e", { ctrl: true, shift: true })
2865
+
2866
+ expect(editor.hasSelection()).toBe(true)
2867
+ expect(editor.getSelectedText()).toBe("World")
2868
+ })
2869
+
2870
+ it("should work on multiline text", async () => {
2871
+ const { textarea: editor } = await createTextareaRenderable(kittyRenderer, kittyRenderOnce, {
2872
+ initialValue: "Line 1\nLine 2\nLine 3",
2873
+ width: 40,
2874
+ height: 10,
2875
+ })
2876
+
2877
+ editor.focus()
2878
+ editor.editBuffer.setCursor(1, 4) // Middle of second line
2879
+
2880
+ // Select to start of line 2
2881
+ kittyMockInput.pressKey("a", { ctrl: true, shift: true })
2882
+ expect(editor.getSelectedText()).toBe("Line ")
2883
+
2884
+ // Clear selection and move to same position
2885
+ editor.editBuffer.setCursor(1, 4)
2886
+
2887
+ // Select to end of line 2
2888
+ kittyMockInput.pressKey("e", { ctrl: true, shift: true })
2889
+ expect(editor.getSelectedText()).toBe(" 2")
2890
+ })
2891
+
2892
+ it("should handle line wrapping behavior", async () => {
2893
+ const { textarea: editor } = await createTextareaRenderable(kittyRenderer, kittyRenderOnce, {
2894
+ initialValue: "Line 1\nLine 2",
2895
+ width: 40,
2896
+ height: 10,
2897
+ })
2898
+
2899
+ editor.focus()
2900
+ // At end of line 1
2901
+ editor.editBuffer.setCursor(0, 6)
2902
+
2903
+ // First ctrl+shift+a from EOL should select entire line
2904
+ kittyMockInput.pressKey("a", { ctrl: true, shift: true })
2905
+ expect(editor.getSelectedText()).toBe("Line 1")
2906
+
2907
+ // Reset
2908
+ editor.editBuffer.setCursor(0, 0)
2909
+
2910
+ // From start, ctrl+shift+e should select line, then wrap to next line
2911
+ kittyMockInput.pressKey("e", { ctrl: true, shift: true })
2912
+ const cursor = editor.editBuffer.getCursorPosition()
2913
+ expect(cursor.col).toBeGreaterThan(0)
2914
+ })
2915
+
2916
+ it("should not interfere with ctrl+a (without shift)", async () => {
2917
+ const { textarea: editor } = await createTextareaRenderable(currentRenderer, renderOnce, {
2918
+ initialValue: "Hello World",
2919
+ width: 40,
2920
+ height: 10,
2921
+ })
2922
+
2923
+ editor.focus()
2924
+ editor.editBuffer.setCursor(0, 11)
2925
+
2926
+ // ctrl+a (without shift) should just move, not select
2927
+ currentMockInput.pressKey("a", { ctrl: true })
2928
+
2929
+ expect(editor.hasSelection()).toBe(false)
2930
+ expect(editor.logicalCursor.col).toBe(0)
2931
+ })
2932
+
2933
+ it("should not interfere with ctrl+e (without shift)", async () => {
2934
+ const { textarea: editor } = await createTextareaRenderable(currentRenderer, renderOnce, {
2935
+ initialValue: "Hello World",
2936
+ width: 40,
2937
+ height: 10,
2938
+ })
2939
+
2940
+ editor.focus()
2941
+ editor.editBuffer.setCursor(0, 0)
2942
+
2943
+ // ctrl+e (without shift) should just move, not select
2944
+ currentMockInput.pressKey("e", { ctrl: true })
2945
+
2946
+ expect(editor.hasSelection()).toBe(false)
2947
+ expect(editor.logicalCursor.col).toBe(11)
2948
+ })
2949
+ })
2950
+
2951
+ describe("Visual line navigation with meta+a/e", () => {
2952
+ it("should navigate to visual line start with meta+a (no wrapping)", async () => {
2953
+ const { textarea: editor } = await createTextareaRenderable(currentRenderer, renderOnce, {
2954
+ initialValue: "Hello World",
2955
+ width: 40,
2956
+ height: 10,
2957
+ wrapMode: "none",
2958
+ })
2959
+
2960
+ editor.focus()
2961
+ editor.editBuffer.setCursor(0, 6)
2962
+
2963
+ currentMockInput.pressKey("a", { meta: true })
2964
+
2965
+ expect(editor.logicalCursor.col).toBe(0)
2966
+ })
2967
+
2968
+ it("should navigate to visual line end with meta+e (no wrapping)", async () => {
2969
+ const { textarea: editor } = await createTextareaRenderable(currentRenderer, renderOnce, {
2970
+ initialValue: "Hello World",
2971
+ width: 40,
2972
+ height: 10,
2973
+ wrapMode: "none",
2974
+ })
2975
+
2976
+ editor.focus()
2977
+ editor.editBuffer.setCursor(0, 6)
2978
+
2979
+ currentMockInput.pressKey("e", { meta: true })
2980
+
2981
+ expect(editor.logicalCursor.col).toBe(11)
2982
+ })
2983
+
2984
+ it("should navigate to visual line start with meta+a (with wrapping)", async () => {
2985
+ const { textarea: editor } = await createTextareaRenderable(currentRenderer, renderOnce, {
2986
+ initialValue: "ABCDEFGHIJKLMNOPQRSTUVWXYZ",
2987
+ width: 20,
2988
+ height: 10,
2989
+ wrapMode: "char",
2990
+ })
2991
+
2992
+ editor.focus()
2993
+ editor.editBuffer.setCursor(0, 22) // In second visual line
2994
+
2995
+ currentMockInput.pressKey("a", { meta: true })
2996
+
2997
+ const cursor = editor.logicalCursor
2998
+ expect(cursor.col).toBe(20) // Start of second visual line, not 0
2999
+ })
3000
+
3001
+ it("should navigate to visual line end with meta+e (with wrapping)", async () => {
3002
+ const { textarea: editor } = await createTextareaRenderable(currentRenderer, renderOnce, {
3003
+ initialValue: "ABCDEFGHIJKLMNOPQRSTUVWXYZ",
3004
+ width: 20,
3005
+ height: 10,
3006
+ wrapMode: "char",
3007
+ })
3008
+
3009
+ editor.focus()
3010
+ editor.editBuffer.setCursor(0, 5) // In first visual line
3011
+
3012
+ currentMockInput.pressKey("e", { meta: true })
3013
+
3014
+ const cursor = editor.logicalCursor
3015
+ expect(cursor.col).toBe(19)
3016
+ })
3017
+
3018
+ it("should differ from ctrl+a/e when wrapping is enabled", async () => {
3019
+ const { textarea: editor } = await createTextareaRenderable(currentRenderer, renderOnce, {
3020
+ initialValue: "ABCDEFGHIJKLMNOPQRSTUVWXYZ",
3021
+ width: 20,
3022
+ height: 10,
3023
+ wrapMode: "char",
3024
+ })
3025
+
3026
+ editor.focus()
3027
+ editor.editBuffer.setCursor(0, 22)
3028
+
3029
+ // meta+a goes to visual line start (col 20)
3030
+ currentMockInput.pressKey("a", { meta: true })
3031
+ const visualHomeCol = editor.logicalCursor.col
3032
+ expect(visualHomeCol).toBe(20)
3033
+
3034
+ // Reset cursor
3035
+ editor.editBuffer.setCursor(0, 22)
3036
+
3037
+ // ctrl+a goes to logical line start (col 0)
3038
+ currentMockInput.pressKey("a", { ctrl: true })
3039
+ const logicalHomeCol = editor.logicalCursor.col
3040
+ expect(logicalHomeCol).toBe(0)
3041
+
3042
+ expect(visualHomeCol).not.toBe(logicalHomeCol)
3043
+ })
3044
+ })
3045
+
3046
+ describe("Visual line selection with meta+shift+a/e", () => {
3047
+ let kittyRenderer: TestRenderer
3048
+ let kittyRenderOnce: () => Promise<void>
3049
+ let kittyMockInput: MockInput
3050
+
3051
+ beforeEach(async () => {
3052
+ ;({
3053
+ renderer: kittyRenderer,
3054
+ renderOnce: kittyRenderOnce,
3055
+ mockInput: kittyMockInput,
3056
+ } = await createTestRenderer({
3057
+ width: 80,
3058
+ height: 24,
3059
+ kittyKeyboard: true,
3060
+ }))
3061
+ })
3062
+
3063
+ afterEach(() => {
3064
+ kittyRenderer.destroy()
3065
+ })
3066
+
3067
+ it("should select to visual line start with meta+shift+a", async () => {
3068
+ const { textarea: editor } = await createTextareaRenderable(kittyRenderer, kittyRenderOnce, {
3069
+ initialValue: "ABCDEFGHIJKLMNOPQRSTUVWXYZ",
3070
+ width: 20,
3071
+ height: 10,
3072
+ wrapMode: "char",
3073
+ })
3074
+
3075
+ editor.focus()
3076
+ editor.editBuffer.setCursor(0, 25) // In second visual line
3077
+
3078
+ kittyMockInput.pressKey("a", { meta: true, shift: true })
3079
+
3080
+ expect(editor.hasSelection()).toBe(true)
3081
+ const selectedText = editor.getSelectedText()
3082
+ expect(selectedText.length).toBe(6) // From col 20 to 26 (includes char at 25)
3083
+ })
3084
+
3085
+ it("should select to visual line end with meta+shift+e", async () => {
3086
+ const { textarea: editor } = await createTextareaRenderable(kittyRenderer, kittyRenderOnce, {
3087
+ initialValue: "ABCDEFGHIJKLMNOPQRSTUVWXYZ",
3088
+ width: 20,
3089
+ height: 10,
3090
+ wrapMode: "char",
3091
+ })
3092
+
3093
+ editor.focus()
3094
+ editor.editBuffer.setCursor(0, 10) // In first visual line
3095
+
3096
+ kittyMockInput.pressKey("e", { meta: true, shift: true })
3097
+
3098
+ expect(editor.hasSelection()).toBe(true)
3099
+ const selectedText = editor.getSelectedText()
3100
+ expect(selectedText).toBe("KLMNOPQRS")
3101
+ })
3102
+
3103
+ it("should work without wrapping (same as logical)", async () => {
3104
+ const { textarea: editor } = await createTextareaRenderable(kittyRenderer, kittyRenderOnce, {
3105
+ initialValue: "Hello World",
3106
+ width: 40,
3107
+ height: 10,
3108
+ wrapMode: "none",
3109
+ })
3110
+
3111
+ editor.focus()
3112
+ editor.editBuffer.setCursor(0, 6)
3113
+
3114
+ kittyMockInput.pressKey("a", { meta: true, shift: true })
3115
+ expect(editor.getSelectedText()).toBe("Hello W")
3116
+
3117
+ editor.editBuffer.setCursor(0, 6)
3118
+ kittyMockInput.pressKey("e", { meta: true, shift: true })
3119
+ expect(editor.getSelectedText()).toBe("World")
3120
+ })
3121
+
3122
+ it("should differ from ctrl+shift+a/e when wrapping is enabled", async () => {
3123
+ const { textarea: editor } = await createTextareaRenderable(kittyRenderer, kittyRenderOnce, {
3124
+ initialValue: "ABCDEFGHIJKLMNOPQRSTUVWXYZ",
3125
+ width: 20,
3126
+ height: 10,
3127
+ wrapMode: "char",
3128
+ })
3129
+
3130
+ editor.focus()
3131
+ editor.editBuffer.setCursor(0, 25) // In second visual line
3132
+
3133
+ // meta+shift+a selects to visual line start
3134
+ kittyMockInput.pressKey("a", { meta: true, shift: true })
3135
+ const visualSelection = editor.getSelectedText()
3136
+ expect(visualSelection.length).toBe(6) // From 20 to 26
3137
+
3138
+ // Reset
3139
+ editor.editBuffer.setCursor(0, 25)
3140
+
3141
+ // ctrl+shift+a selects to logical line start
3142
+ kittyMockInput.pressKey("a", { ctrl: true, shift: true })
3143
+ const logicalSelection = editor.getSelectedText()
3144
+ expect(logicalSelection.length).toBe(26) // From 0 to 26
3145
+
3146
+ expect(visualSelection).not.toBe(logicalSelection)
3147
+ })
3148
+ })
3149
+ })