@xincli/opentui-core 0.4.6

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 (476) hide show
  1. package/README.md +63 -0
  2. package/dev/keypress-debug-renderer.ts +148 -0
  3. package/dev/keypress-debug.ts +43 -0
  4. package/dev/print-env-vars.ts +32 -0
  5. package/dev/test-tmux-graphics-334.sh +68 -0
  6. package/dev/test-tmux-theme-queries.sh +151 -0
  7. package/dev/thai-debug-test.ts +68 -0
  8. package/dev/theme-mode.ts +290 -0
  9. package/docs/development.md +144 -0
  10. package/package.json +102 -0
  11. package/prebuilt/aarch64-android/libopentui.so +0 -0
  12. package/scripts/build-android.ts +226 -0
  13. package/scripts/build-native-termux.sh +525 -0
  14. package/scripts/build.ts +530 -0
  15. package/scripts/dist-test.ts +312 -0
  16. package/scripts/package-prebuilt.ts +110 -0
  17. package/scripts/publish.ts +60 -0
  18. package/scripts/test-node-hook.mjs +16 -0
  19. package/scripts/test-node.ts +241 -0
  20. package/scripts/vendor-deps.sh +73 -0
  21. package/src/NativeSpanFeed.ts +375 -0
  22. package/src/Renderable.ts +1878 -0
  23. package/src/__snapshots__/buffer.test.ts.snap +28 -0
  24. package/src/animation/Timeline.test.ts +2709 -0
  25. package/src/animation/Timeline.ts +598 -0
  26. package/src/ansi.ts +22 -0
  27. package/src/audio.ts +479 -0
  28. package/src/benchmark/attenuation-benchmark.ts +81 -0
  29. package/src/benchmark/audio-playback-benchmark.ts +344 -0
  30. package/src/benchmark/box-draw-benchmark.ts +1042 -0
  31. package/src/benchmark/colormatrix-benchmark.ts +123 -0
  32. package/src/benchmark/gain-benchmark.ts +80 -0
  33. package/src/benchmark/latest-all-bench-run.json +707 -0
  34. package/src/benchmark/latest-async-bench-run.json +336 -0
  35. package/src/benchmark/latest-default-bench-run.json +657 -0
  36. package/src/benchmark/latest-large-bench-run.json +707 -0
  37. package/src/benchmark/latest-quick-bench-run.json +207 -0
  38. package/src/benchmark/layout-benchmark.ts +2547 -0
  39. package/src/benchmark/markdown-benchmark.ts +1796 -0
  40. package/src/benchmark/native-span-feed-async-benchmark.ts +355 -0
  41. package/src/benchmark/native-span-feed-benchmark.md +56 -0
  42. package/src/benchmark/native-span-feed-benchmark.ts +596 -0
  43. package/src/benchmark/native-span-feed-compare.ts +280 -0
  44. package/src/benchmark/render-traversal-benchmark.ts +928 -0
  45. package/src/benchmark/text-buffer-render-benchmark.ts +874 -0
  46. package/src/benchmark/text-table-benchmark.ts +948 -0
  47. package/src/buffer.test.ts +292 -0
  48. package/src/buffer.ts +564 -0
  49. package/src/console.test.ts +629 -0
  50. package/src/console.ts +1253 -0
  51. package/src/edit-buffer.test.ts +1852 -0
  52. package/src/edit-buffer.ts +417 -0
  53. package/src/editor-view.test.ts +1056 -0
  54. package/src/editor-view.ts +290 -0
  55. package/src/index.ts +25 -0
  56. package/src/lib/KeyHandler.integration.test.ts +292 -0
  57. package/src/lib/KeyHandler.stopPropagation.test.ts +289 -0
  58. package/src/lib/KeyHandler.test.ts +662 -0
  59. package/src/lib/KeyHandler.ts +222 -0
  60. package/src/lib/RGBA.test.ts +60 -0
  61. package/src/lib/RGBA.ts +343 -0
  62. package/src/lib/ascii.font.ts +330 -0
  63. package/src/lib/border.test.ts +83 -0
  64. package/src/lib/border.ts +170 -0
  65. package/src/lib/bunfs.test.ts +27 -0
  66. package/src/lib/bunfs.ts +18 -0
  67. package/src/lib/clipboard.test.ts +63 -0
  68. package/src/lib/clipboard.ts +41 -0
  69. package/src/lib/clock.ts +35 -0
  70. package/src/lib/data-paths.test.ts +133 -0
  71. package/src/lib/data-paths.ts +109 -0
  72. package/src/lib/debounce.ts +106 -0
  73. package/src/lib/detect-links.test.ts +98 -0
  74. package/src/lib/detect-links.ts +56 -0
  75. package/src/lib/env.test.ts +228 -0
  76. package/src/lib/env.ts +209 -0
  77. package/src/lib/extmarks-history.ts +51 -0
  78. package/src/lib/extmarks-multiwidth.test.ts +324 -0
  79. package/src/lib/extmarks.test.ts +3547 -0
  80. package/src/lib/extmarks.ts +861 -0
  81. package/src/lib/fonts/block.json +405 -0
  82. package/src/lib/fonts/grid.json +265 -0
  83. package/src/lib/fonts/huge.json +741 -0
  84. package/src/lib/fonts/pallet.json +314 -0
  85. package/src/lib/fonts/shade.json +591 -0
  86. package/src/lib/fonts/slick.json +321 -0
  87. package/src/lib/fonts/tiny.json +69 -0
  88. package/src/lib/hast-styled-text.ts +59 -0
  89. package/src/lib/index.ts +22 -0
  90. package/src/lib/keybinding.internal.test.ts +342 -0
  91. package/src/lib/keybinding.internal.ts +182 -0
  92. package/src/lib/objects-in-viewport.test.ts +789 -0
  93. package/src/lib/objects-in-viewport.ts +153 -0
  94. package/src/lib/output.capture.ts +58 -0
  95. package/src/lib/parse.keypress-kitty.protocol.test.ts +347 -0
  96. package/src/lib/parse.keypress-kitty.test.ts +712 -0
  97. package/src/lib/parse.keypress-kitty.ts +470 -0
  98. package/src/lib/parse.keypress.test.ts +2020 -0
  99. package/src/lib/parse.keypress.ts +480 -0
  100. package/src/lib/parse.mouse.test.ts +552 -0
  101. package/src/lib/parse.mouse.ts +232 -0
  102. package/src/lib/paste.ts +18 -0
  103. package/src/lib/queue.ts +65 -0
  104. package/src/lib/render-geometry.ts +36 -0
  105. package/src/lib/renderable.validations.test.ts +87 -0
  106. package/src/lib/renderable.validations.ts +83 -0
  107. package/src/lib/scroll-acceleration.ts +98 -0
  108. package/src/lib/selection.ts +261 -0
  109. package/src/lib/singleton.ts +34 -0
  110. package/src/lib/stdin-parser.test.ts +2439 -0
  111. package/src/lib/stdin-parser.ts +2007 -0
  112. package/src/lib/styled-text.ts +178 -0
  113. package/src/lib/terminal-capability-detection.test.ts +226 -0
  114. package/src/lib/terminal-capability-detection.ts +98 -0
  115. package/src/lib/terminal-palette.test.ts +954 -0
  116. package/src/lib/terminal-palette.ts +441 -0
  117. package/src/lib/tree-sitter/assets/README.md +119 -0
  118. package/src/lib/tree-sitter/assets/javascript/highlights.scm +205 -0
  119. package/src/lib/tree-sitter/assets/javascript/tree-sitter-javascript.wasm +0 -0
  120. package/src/lib/tree-sitter/assets/markdown/highlights.scm +150 -0
  121. package/src/lib/tree-sitter/assets/markdown/injections.scm +27 -0
  122. package/src/lib/tree-sitter/assets/markdown/tree-sitter-markdown.wasm +0 -0
  123. package/src/lib/tree-sitter/assets/markdown_inline/highlights.scm +115 -0
  124. package/src/lib/tree-sitter/assets/markdown_inline/tree-sitter-markdown_inline.wasm +0 -0
  125. package/src/lib/tree-sitter/assets/typescript/highlights.scm +604 -0
  126. package/src/lib/tree-sitter/assets/typescript/tree-sitter-typescript.wasm +0 -0
  127. package/src/lib/tree-sitter/assets/update.ts +360 -0
  128. package/src/lib/tree-sitter/assets/zig/highlights.scm +284 -0
  129. package/src/lib/tree-sitter/assets/zig/tree-sitter-zig.wasm +0 -0
  130. package/src/lib/tree-sitter/assets.d.ts +9 -0
  131. package/src/lib/tree-sitter/cache.test.ts +291 -0
  132. package/src/lib/tree-sitter/client.test.ts +1434 -0
  133. package/src/lib/tree-sitter/client.ts +847 -0
  134. package/src/lib/tree-sitter/default-parsers.ts +133 -0
  135. package/src/lib/tree-sitter/download-utils.ts +148 -0
  136. package/src/lib/tree-sitter/index.ts +75 -0
  137. package/src/lib/tree-sitter/parser.worker.ts +1098 -0
  138. package/src/lib/tree-sitter/parsers-config.ts +81 -0
  139. package/src/lib/tree-sitter/resolve-ft.test.ts +55 -0
  140. package/src/lib/tree-sitter/resolve-ft.ts +189 -0
  141. package/src/lib/tree-sitter/types.ts +132 -0
  142. package/src/lib/tree-sitter/update-assets.ts +10 -0
  143. package/src/lib/tree-sitter-styled-text.test.ts +1253 -0
  144. package/src/lib/tree-sitter-styled-text.ts +314 -0
  145. package/src/lib/validate-dir-name.ts +55 -0
  146. package/src/lib/yoga.options.test.ts +628 -0
  147. package/src/lib/yoga.options.ts +346 -0
  148. package/src/native-event-worker-repro.test.ts +48 -0
  149. package/src/native-event-worker-repro.worker.ts +9 -0
  150. package/src/native-handle.test.ts +221 -0
  151. package/src/platform/ffi.test.ts +516 -0
  152. package/src/platform/ffi.ts +653 -0
  153. package/src/platform/runtime.test.ts +52 -0
  154. package/src/platform/runtime.ts +121 -0
  155. package/src/platform/test.ts +45 -0
  156. package/src/platform/worker-handler-cleanup.fixture.ts +12 -0
  157. package/src/platform/worker-onmessage-startup.fixture.ts +10 -0
  158. package/src/platform/worker-startup.fixture.ts +9 -0
  159. package/src/platform/worker.node-test.ts +153 -0
  160. package/src/platform/worker.ts +425 -0
  161. package/src/plugins/core-slot.ts +579 -0
  162. package/src/plugins/registry.ts +402 -0
  163. package/src/plugins/types.ts +46 -0
  164. package/src/post/effects.ts +948 -0
  165. package/src/post/filters.ts +512 -0
  166. package/src/post/matrices.ts +288 -0
  167. package/src/renderables/ASCIIFont.ts +219 -0
  168. package/src/renderables/Box.test.ts +474 -0
  169. package/src/renderables/Box.ts +353 -0
  170. package/src/renderables/Code.test.ts +2388 -0
  171. package/src/renderables/Code.ts +555 -0
  172. package/src/renderables/Diff.regression.test.ts +381 -0
  173. package/src/renderables/Diff.test.ts +3212 -0
  174. package/src/renderables/Diff.ts +1278 -0
  175. package/src/renderables/EditBufferRenderable.test.ts +288 -0
  176. package/src/renderables/EditBufferRenderable.ts +1152 -0
  177. package/src/renderables/FrameBuffer.ts +47 -0
  178. package/src/renderables/Input.test.ts +1310 -0
  179. package/src/renderables/Input.ts +273 -0
  180. package/src/renderables/LineNumberRenderable.ts +725 -0
  181. package/src/renderables/Markdown.ts +2144 -0
  182. package/src/renderables/ScrollBar.ts +423 -0
  183. package/src/renderables/ScrollBox.ts +903 -0
  184. package/src/renderables/Select.test.ts +1134 -0
  185. package/src/renderables/Select.ts +535 -0
  186. package/src/renderables/Slider.test.ts +456 -0
  187. package/src/renderables/Slider.ts +342 -0
  188. package/src/renderables/TabSelect.test.ts +238 -0
  189. package/src/renderables/TabSelect.ts +447 -0
  190. package/src/renderables/Text.selection-buffer.test.ts +118 -0
  191. package/src/renderables/Text.test.ts +2662 -0
  192. package/src/renderables/Text.ts +147 -0
  193. package/src/renderables/TextBufferRenderable.ts +504 -0
  194. package/src/renderables/TextNode.test.ts +1137 -0
  195. package/src/renderables/TextNode.ts +379 -0
  196. package/src/renderables/TextTable.test.ts +1411 -0
  197. package/src/renderables/TextTable.ts +1434 -0
  198. package/src/renderables/Textarea.ts +425 -0
  199. package/src/renderables/TimeToFirstDraw.ts +89 -0
  200. package/src/renderables/__snapshots__/Code.test.ts.snap +13 -0
  201. package/src/renderables/__snapshots__/Diff.test.ts.snap +785 -0
  202. package/src/renderables/__snapshots__/Text.test.ts.snap +421 -0
  203. package/src/renderables/__snapshots__/TextTable.test.ts.snap +215 -0
  204. package/src/renderables/__tests__/Code.test.ts +55 -0
  205. package/src/renderables/__tests__/LineNumberRenderable.scrollbox-simple.test.ts +144 -0
  206. package/src/renderables/__tests__/LineNumberRenderable.scrollbox.test.ts +827 -0
  207. package/src/renderables/__tests__/LineNumberRenderable.test.ts +1906 -0
  208. package/src/renderables/__tests__/LineNumberRenderable.wrapping.test.ts +85 -0
  209. package/src/renderables/__tests__/Markdown.code-colors.test.ts +288 -0
  210. package/src/renderables/__tests__/Markdown.test.ts +4175 -0
  211. package/src/renderables/__tests__/MultiRenderable.selection.test.ts +87 -0
  212. package/src/renderables/__tests__/Textarea.buffer.test.ts +683 -0
  213. package/src/renderables/__tests__/Textarea.destroyed-events.test.ts +675 -0
  214. package/src/renderables/__tests__/Textarea.editing.test.ts +2120 -0
  215. package/src/renderables/__tests__/Textarea.error-handling.test.ts +35 -0
  216. package/src/renderables/__tests__/Textarea.events.test.ts +738 -0
  217. package/src/renderables/__tests__/Textarea.highlights.test.ts +590 -0
  218. package/src/renderables/__tests__/Textarea.keybinding.test.ts +3275 -0
  219. package/src/renderables/__tests__/Textarea.paste.test.ts +357 -0
  220. package/src/renderables/__tests__/Textarea.rendering.test.ts +1927 -0
  221. package/src/renderables/__tests__/Textarea.scroll.test.ts +733 -0
  222. package/src/renderables/__tests__/Textarea.selection.test.ts +1589 -0
  223. package/src/renderables/__tests__/Textarea.stress.test.ts +670 -0
  224. package/src/renderables/__tests__/Textarea.undo-redo.test.ts +383 -0
  225. package/src/renderables/__tests__/Textarea.visual-lines.test.ts +310 -0
  226. package/src/renderables/__tests__/__snapshots__/LineNumberRenderable.code.test.ts.snap +221 -0
  227. package/src/renderables/__tests__/__snapshots__/LineNumberRenderable.scrollbox-simple.test.ts.snap +89 -0
  228. package/src/renderables/__tests__/__snapshots__/LineNumberRenderable.scrollbox.test.ts.snap +457 -0
  229. package/src/renderables/__tests__/__snapshots__/LineNumberRenderable.test.ts.snap +158 -0
  230. package/src/renderables/__tests__/__snapshots__/Textarea.rendering.test.ts.snap +387 -0
  231. package/src/renderables/__tests__/markdown-parser.test.ts +241 -0
  232. package/src/renderables/__tests__/renderable-test-utils.ts +60 -0
  233. package/src/renderables/composition/README.md +8 -0
  234. package/src/renderables/composition/VRenderable.ts +32 -0
  235. package/src/renderables/composition/constructs.ts +127 -0
  236. package/src/renderables/composition/vnode.ts +277 -0
  237. package/src/renderables/index.ts +23 -0
  238. package/src/renderables/markdown-parser.ts +79 -0
  239. package/src/renderer-theme-mode.ts +199 -0
  240. package/src/renderer.ts +4975 -0
  241. package/src/runtime-plugin-support-configure.ts +63 -0
  242. package/src/runtime-plugin-support.ts +13 -0
  243. package/src/runtime-plugin.ts +626 -0
  244. package/src/specs/terminal-startup.md +64 -0
  245. package/src/syntax-style.test.ts +841 -0
  246. package/src/syntax-style.ts +274 -0
  247. package/src/testing/README.md +219 -0
  248. package/src/testing/bun-test-node.ts +880 -0
  249. package/src/testing/capture-spans.test.ts +216 -0
  250. package/src/testing/integration.test.ts +276 -0
  251. package/src/testing/manual-clock.ts +117 -0
  252. package/src/testing/mock-keys.test.ts +1378 -0
  253. package/src/testing/mock-keys.ts +457 -0
  254. package/src/testing/mock-mouse.test.ts +218 -0
  255. package/src/testing/mock-mouse.ts +247 -0
  256. package/src/testing/mock-tree-sitter-client.ts +81 -0
  257. package/src/testing/spy.ts +13 -0
  258. package/src/testing/terminal-capabilities.ts +47 -0
  259. package/src/testing/test-recorder.test.ts +410 -0
  260. package/src/testing/test-recorder.ts +133 -0
  261. package/src/testing/test-renderer.ts +375 -0
  262. package/src/testing/test-renderer.wait.test.ts +278 -0
  263. package/src/testing/test-streams.ts +31 -0
  264. package/src/testing.ts +9 -0
  265. package/src/tests/__snapshots__/absolute-positioning.snapshot.test.ts.snap +481 -0
  266. package/src/tests/__snapshots__/renderable.snapshot.test.ts.snap +19 -0
  267. package/src/tests/__snapshots__/scrollbox.test.ts.snap +29 -0
  268. package/src/tests/absolute-positioning.snapshot.test.ts +638 -0
  269. package/src/tests/allocator-stats.test.ts +53 -0
  270. package/src/tests/audio.test.ts +303 -0
  271. package/src/tests/destroy-during-render.test.ts +200 -0
  272. package/src/tests/destroy-on-exit.fixture.ts +36 -0
  273. package/src/tests/destroy-on-exit.test.ts +62 -0
  274. package/src/tests/ffi-borrowed-pointer-callsites.test.ts +153 -0
  275. package/src/tests/hover-cursor.test.ts +98 -0
  276. package/src/tests/native-backed-measurement-lifecycle.test.ts +133 -0
  277. package/src/tests/native-backed-measurement-parity.test.ts +322 -0
  278. package/src/tests/native-span-feed-async.test.ts +173 -0
  279. package/src/tests/native-span-feed-close.test.ts +120 -0
  280. package/src/tests/native-span-feed-coverage.test.ts +227 -0
  281. package/src/tests/native-span-feed-edge-cases.test.ts +384 -0
  282. package/src/tests/native-span-feed-use-after-free.test.ts +45 -0
  283. package/src/tests/opacity.test.ts +123 -0
  284. package/src/tests/renderable.snapshot.test.ts +524 -0
  285. package/src/tests/renderable.test.ts +1851 -0
  286. package/src/tests/renderer.clock.test.ts +270 -0
  287. package/src/tests/renderer.console-startup.test.ts +2151 -0
  288. package/src/tests/renderer.control.test.ts +458 -0
  289. package/src/tests/renderer.core-slot-binding.test.ts +962 -0
  290. package/src/tests/renderer.cursor.test.ts +26 -0
  291. package/src/tests/renderer.custom-stdout.test.ts +1112 -0
  292. package/src/tests/renderer.destroy-during-render.test.ts +147 -0
  293. package/src/tests/renderer.focus-restore.test.ts +257 -0
  294. package/src/tests/renderer.focus.test.ts +329 -0
  295. package/src/tests/renderer.idle.test.ts +219 -0
  296. package/src/tests/renderer.input.test.ts +2615 -0
  297. package/src/tests/renderer.kitty-flags.test.ts +195 -0
  298. package/src/tests/renderer.lifecycle.test.ts +34 -0
  299. package/src/tests/renderer.mouse.test.ts +1315 -0
  300. package/src/tests/renderer.notifications.test.ts +27 -0
  301. package/src/tests/renderer.palette.test.ts +1199 -0
  302. package/src/tests/renderer.remote.test.ts +247 -0
  303. package/src/tests/renderer.render-stats.test.ts +146 -0
  304. package/src/tests/renderer.scrollback-surface.test.ts +474 -0
  305. package/src/tests/renderer.selection.test.ts +138 -0
  306. package/src/tests/renderer.slot-registry.test.ts +684 -0
  307. package/src/tests/renderer.tracker.test.ts +202 -0
  308. package/src/tests/renderer.useMouse.test.ts +83 -0
  309. package/src/tests/runtime-plugin-node-modules-cycle.fixture.ts +76 -0
  310. package/src/tests/runtime-plugin-node-modules-import-like-string.fixture.ts +48 -0
  311. package/src/tests/runtime-plugin-node-modules-mjs.fixture.ts +43 -0
  312. package/src/tests/runtime-plugin-node-modules-no-bare-rewrite.fixture.ts +67 -0
  313. package/src/tests/runtime-plugin-node-modules-package-type-cache.fixture.ts +72 -0
  314. package/src/tests/runtime-plugin-node-modules-runtime-specifier.fixture.ts +44 -0
  315. package/src/tests/runtime-plugin-node-modules-scoped-package-bare-rewrite.fixture.ts +85 -0
  316. package/src/tests/runtime-plugin-path-alias.fixture.ts +43 -0
  317. package/src/tests/runtime-plugin-resolve-roots.fixture.ts +65 -0
  318. package/src/tests/runtime-plugin-support-configure.fixture.ts +31 -0
  319. package/src/tests/runtime-plugin-support-late-addition.fixture.ts +17 -0
  320. package/src/tests/runtime-plugin-support.fixture.ts +11 -0
  321. package/src/tests/runtime-plugin-support.test.ts +54 -0
  322. package/src/tests/runtime-plugin-windows-file-url.fixture.ts +30 -0
  323. package/src/tests/runtime-plugin.fixture.ts +40 -0
  324. package/src/tests/runtime-plugin.test.ts +369 -0
  325. package/src/tests/scrollbox-culling-bug.test.ts +114 -0
  326. package/src/tests/scrollbox-hitgrid-resize.test.ts +136 -0
  327. package/src/tests/scrollbox-hitgrid.test.ts +909 -0
  328. package/src/tests/scrollbox.test.ts +1895 -0
  329. package/src/tests/wrap-resize-perf.test.ts +276 -0
  330. package/src/tests/yoga-api-coverage.test.ts +409 -0
  331. package/src/tests/yoga-callback-stress.test.ts +122 -0
  332. package/src/tests/yoga-ffi.test.ts +117 -0
  333. package/src/tests/yoga-setters.test.ts +921 -0
  334. package/src/tests/yoga-upstream/YGAlignBaselineTest.test.ts +124 -0
  335. package/src/tests/yoga-upstream/YGComputedBorderTest.test.ts +27 -0
  336. package/src/tests/yoga-upstream/YGComputedMarginTest.test.ts +27 -0
  337. package/src/tests/yoga-upstream/YGComputedPaddingTest.test.ts +27 -0
  338. package/src/tests/yoga-upstream/YGDirtiedTest.test.ts +157 -0
  339. package/src/tests/yoga-upstream/YGErrataTest.test.ts +40 -0
  340. package/src/tests/yoga-upstream/YGFlexBasisAuto.test.ts +23 -0
  341. package/src/tests/yoga-upstream/YGHasNewLayout.test.ts +81 -0
  342. package/src/tests/yoga-upstream/YGMeasureCacheTest.test.ts +31 -0
  343. package/src/tests/yoga-upstream/YGMeasureTest.test.ts +70 -0
  344. package/src/tests/yoga-upstream/generated/YGAbsolutePositionTest.test.ts +1864 -0
  345. package/src/tests/yoga-upstream/generated/YGAlignContentTest.test.ts +5829 -0
  346. package/src/tests/yoga-upstream/generated/YGAlignItemsTest.test.ts +2444 -0
  347. package/src/tests/yoga-upstream/generated/YGAlignSelfTest.test.ts +293 -0
  348. package/src/tests/yoga-upstream/generated/YGAndroidNewsFeed.test.ts +315 -0
  349. package/src/tests/yoga-upstream/generated/YGAspectRatioTest.test.ts +231 -0
  350. package/src/tests/yoga-upstream/generated/YGAutoTest.test.ts +347 -0
  351. package/src/tests/yoga-upstream/generated/YGBorderTest.test.ts +256 -0
  352. package/src/tests/yoga-upstream/generated/YGBoxSizingTest.test.ts +2747 -0
  353. package/src/tests/yoga-upstream/generated/YGDimensionTest.test.ts +129 -0
  354. package/src/tests/yoga-upstream/generated/YGDisplayContentsTest.test.ts +109 -0
  355. package/src/tests/yoga-upstream/generated/YGDisplayTest.test.ts +1097 -0
  356. package/src/tests/yoga-upstream/generated/YGFlexDirectionTest.test.ts +4562 -0
  357. package/src/tests/yoga-upstream/generated/YGFlexTest.test.ts +677 -0
  358. package/src/tests/yoga-upstream/generated/YGFlexWrapTest.test.ts +2071 -0
  359. package/src/tests/yoga-upstream/generated/YGGapTest.test.ts +3303 -0
  360. package/src/tests/yoga-upstream/generated/YGIntrinsicSizeTest.test.ts +582 -0
  361. package/src/tests/yoga-upstream/generated/YGJustifyContentTest.test.ts +2150 -0
  362. package/src/tests/yoga-upstream/generated/YGMarginTest.test.ts +1963 -0
  363. package/src/tests/yoga-upstream/generated/YGMinMaxDimensionTest.test.ts +1446 -0
  364. package/src/tests/yoga-upstream/generated/YGPaddingTest.test.ts +354 -0
  365. package/src/tests/yoga-upstream/generated/YGPercentageTest.test.ts +1760 -0
  366. package/src/tests/yoga-upstream/generated/YGRoundingTest.test.ts +1161 -0
  367. package/src/tests/yoga-upstream/generated/YGSizeOverflowTest.test.ts +207 -0
  368. package/src/tests/yoga-upstream/generated/YGStaticPositionTest.test.ts +6338 -0
  369. package/src/tests/yoga-upstream/tools/MeasureCounter.ts +54 -0
  370. package/src/tests/yoga-upstream/tools/utils.ts +81 -0
  371. package/src/text-buffer-view.test.ts +722 -0
  372. package/src/text-buffer-view.ts +193 -0
  373. package/src/text-buffer.test.ts +512 -0
  374. package/src/text-buffer.ts +250 -0
  375. package/src/types.ts +199 -0
  376. package/src/utils.ts +88 -0
  377. package/src/yoga.ts +1146 -0
  378. package/src/zig/ansi.zig +502 -0
  379. package/src/zig/audio.zig +1206 -0
  380. package/src/zig/bench/README.md +50 -0
  381. package/src/zig/bench/buffer-color-blending_bench.zig +350 -0
  382. package/src/zig/bench/buffer-draw-box_bench.zig +786 -0
  383. package/src/zig/bench/buffer-draw-text-buffer_bench.zig +894 -0
  384. package/src/zig/bench/edit-buffer_bench.zig +476 -0
  385. package/src/zig/bench/editor-view_bench.zig +169 -0
  386. package/src/zig/bench/native-span-feed_bench.zig +107 -0
  387. package/src/zig/bench/rope-markers_bench.zig +713 -0
  388. package/src/zig/bench/rope_bench.zig +514 -0
  389. package/src/zig/bench/styled-text_bench.zig +476 -0
  390. package/src/zig/bench/text-buffer-coords_bench.zig +362 -0
  391. package/src/zig/bench/text-buffer-view_bench.zig +459 -0
  392. package/src/zig/bench/text-chunk-graphemes_bench.zig +272 -0
  393. package/src/zig/bench/utf8_bench.zig +799 -0
  394. package/src/zig/bench-utils.zig +431 -0
  395. package/src/zig/bench.zig +223 -0
  396. package/src/zig/buffer-methods.zig +215 -0
  397. package/src/zig/buffer.zig +2515 -0
  398. package/src/zig/build.zig +700 -0
  399. package/src/zig/build.zig.zon +19 -0
  400. package/src/zig/edit-buffer.zig +900 -0
  401. package/src/zig/editor-view.zig +812 -0
  402. package/src/zig/event-bus.zig +28 -0
  403. package/src/zig/event-emitter.zig +65 -0
  404. package/src/zig/file-logger.zig +92 -0
  405. package/src/zig/grapheme.zig +838 -0
  406. package/src/zig/handles.zig +267 -0
  407. package/src/zig/lib.zig +2813 -0
  408. package/src/zig/link.zig +349 -0
  409. package/src/zig/logger.zig +43 -0
  410. package/src/zig/mem-registry.zig +126 -0
  411. package/src/zig/miniaudio_shim.c +21 -0
  412. package/src/zig/native-renderable.zig +112 -0
  413. package/src/zig/native-span-feed-bench-lib.zig +7 -0
  414. package/src/zig/native-span-feed.zig +747 -0
  415. package/src/zig/renderer-output.zig +677 -0
  416. package/src/zig/renderer.zig +2106 -0
  417. package/src/zig/rope.zig +1220 -0
  418. package/src/zig/split-scrollback.zig +88 -0
  419. package/src/zig/syntax-style.zig +174 -0
  420. package/src/zig/terminal.zig +1652 -0
  421. package/src/zig/test.zig +82 -0
  422. package/src/zig/tests/README.md +18 -0
  423. package/src/zig/tests/ansi_test.zig +18 -0
  424. package/src/zig/tests/audio_test.zig +439 -0
  425. package/src/zig/tests/buffer-methods_test.zig +1111 -0
  426. package/src/zig/tests/buffer_test.zig +2926 -0
  427. package/src/zig/tests/edit-buffer-history_test.zig +299 -0
  428. package/src/zig/tests/edit-buffer_test.zig +1688 -0
  429. package/src/zig/tests/editor-view_test.zig +3454 -0
  430. package/src/zig/tests/event-emitter_test.zig +249 -0
  431. package/src/zig/tests/grapheme_test.zig +1329 -0
  432. package/src/zig/tests/handles_test.zig +123 -0
  433. package/src/zig/tests/link_test.zig +220 -0
  434. package/src/zig/tests/mem-registry_test.zig +473 -0
  435. package/src/zig/tests/memory_leak_regression_test.zig +234 -0
  436. package/src/zig/tests/native-renderable_test.zig +16 -0
  437. package/src/zig/tests/native-span-feed_test.zig +1266 -0
  438. package/src/zig/tests/renderer_test.zig +2604 -0
  439. package/src/zig/tests/rope-nested_test.zig +712 -0
  440. package/src/zig/tests/rope_fuzz_test.zig +238 -0
  441. package/src/zig/tests/rope_test.zig +2362 -0
  442. package/src/zig/tests/segment-merge.test.zig +148 -0
  443. package/src/zig/tests/split-scrollback_test.zig +70 -0
  444. package/src/zig/tests/syntax-style_test.zig +558 -0
  445. package/src/zig/tests/terminal_test.zig +1489 -0
  446. package/src/zig/tests/test-renderer.zig +126 -0
  447. package/src/zig/tests/text-buffer-drawing_test.zig +3291 -0
  448. package/src/zig/tests/text-buffer-highlights_test.zig +706 -0
  449. package/src/zig/tests/text-buffer-iterators_test.zig +776 -0
  450. package/src/zig/tests/text-buffer-segment_test.zig +320 -0
  451. package/src/zig/tests/text-buffer-selection_test.zig +1056 -0
  452. package/src/zig/tests/text-buffer-selection_viewport_test.zig +358 -0
  453. package/src/zig/tests/text-buffer-view_test.zig +3672 -0
  454. package/src/zig/tests/text-buffer_test.zig +2191 -0
  455. package/src/zig/tests/unicode-width-map.zon +3909 -0
  456. package/src/zig/tests/utf8_no_zwj_test.zig +260 -0
  457. package/src/zig/tests/utf8_test.zig +4060 -0
  458. package/src/zig/tests/utf8_wcwidth_cursor_test.zig +267 -0
  459. package/src/zig/tests/utf8_wcwidth_test.zig +357 -0
  460. package/src/zig/tests/word-wrap-editing_test.zig +498 -0
  461. package/src/zig/tests/wrap-cache-perf_test.zig +113 -0
  462. package/src/zig/tests/yoga_test.zig +65 -0
  463. package/src/zig/text-buffer-iterators.zig +496 -0
  464. package/src/zig/text-buffer-segment.zig +403 -0
  465. package/src/zig/text-buffer-view.zig +1428 -0
  466. package/src/zig/text-buffer.zig +1272 -0
  467. package/src/zig/utf8.zig +1954 -0
  468. package/src/zig/utils.zig +12 -0
  469. package/src/zig/uucode-stub.zig +76 -0
  470. package/src/zig/vendor/miniaudio/miniaudio.h +93468 -0
  471. package/src/zig/yoga.zig +658 -0
  472. package/src/zig-structs.ts +381 -0
  473. package/src/zig.ts +5260 -0
  474. package/tsconfig.build.json +17 -0
  475. package/tsconfig.json +27 -0
  476. package/tsconfig.node-test.json +138 -0
@@ -0,0 +1,725 @@
1
+ import { Renderable, type BaseRenderable, type RenderableOptions } from "../Renderable.js"
2
+ import { OptimizedBuffer } from "../buffer.js"
3
+ import type { RenderContext, LineInfoProvider } from "../types.js"
4
+ import { RGBA, parseColor } from "../lib/RGBA.js"
5
+ import { stringWidth } from "../platform/runtime.js"
6
+ import { MeasureMode } from "../yoga.js"
7
+
8
+ export interface LineSign {
9
+ before?: string
10
+ beforeColor?: string | RGBA
11
+ after?: string
12
+ afterColor?: string | RGBA
13
+ }
14
+
15
+ export interface LineColorConfig {
16
+ gutter?: string | RGBA
17
+ content?: string | RGBA
18
+ }
19
+
20
+ export interface LineNumberOptions extends RenderableOptions<LineNumberRenderable> {
21
+ target?: Renderable & LineInfoProvider
22
+ fg?: string | RGBA
23
+ bg?: string | RGBA
24
+ minWidth?: number
25
+ paddingRight?: number
26
+ lineColors?: Map<number, string | RGBA | LineColorConfig>
27
+ lineSigns?: Map<number, LineSign>
28
+ lineNumberOffset?: number
29
+ hideLineNumbers?: Set<number>
30
+ lineNumbers?: Map<number, number>
31
+ showLineNumbers?: boolean
32
+ }
33
+
34
+ const DEFAULT_GUTTER_FG = "#888888"
35
+ const DEFAULT_GUTTER_BG = "transparent"
36
+
37
+ class GutterRenderable extends Renderable {
38
+ private target: Renderable & LineInfoProvider
39
+ private _fg: RGBA
40
+ private _bg: RGBA
41
+ private _minWidth: number
42
+ private _paddingRight: number
43
+ private _lineColorsGutter: Map<number, RGBA>
44
+ private _lineColorsContent: Map<number, RGBA>
45
+ private _lineSigns: Map<number, LineSign>
46
+ private _lineNumberOffset: number
47
+ private _hideLineNumbers: Set<number>
48
+ private _lineNumbers: Map<number, number>
49
+ private _maxBeforeWidth: number = 0
50
+ private _maxAfterWidth: number = 0
51
+ private _lastKnownLineCount: number = 0
52
+ private _lastKnownScrollY: number = 0
53
+
54
+ constructor(
55
+ ctx: RenderContext,
56
+ target: Renderable & LineInfoProvider,
57
+ options: {
58
+ fg: RGBA
59
+ bg: RGBA
60
+ minWidth: number
61
+ paddingRight: number
62
+ lineColorsGutter: Map<number, RGBA>
63
+ lineColorsContent: Map<number, RGBA>
64
+ lineSigns: Map<number, LineSign>
65
+ lineNumberOffset: number
66
+ hideLineNumbers: Set<number>
67
+ lineNumbers?: Map<number, number>
68
+ id?: string
69
+ buffered?: boolean
70
+ },
71
+ ) {
72
+ super(ctx, {
73
+ id: options.id,
74
+ width: "auto",
75
+ height: "auto",
76
+ flexGrow: 0,
77
+ flexShrink: 0,
78
+ buffered: options.buffered,
79
+ })
80
+ this.target = target
81
+ this._fg = options.fg
82
+ this._bg = options.bg
83
+ this._minWidth = options.minWidth
84
+ this._paddingRight = options.paddingRight
85
+ this._lineColorsGutter = options.lineColorsGutter
86
+ this._lineColorsContent = options.lineColorsContent
87
+ this._lineSigns = options.lineSigns
88
+ this._lineNumberOffset = options.lineNumberOffset
89
+ this._hideLineNumbers = options.hideLineNumbers
90
+ this._lineNumbers = options.lineNumbers ?? new Map()
91
+ this._lastKnownLineCount = this.target.virtualLineCount
92
+ this._lastKnownScrollY = this.target.scrollY
93
+ this.calculateSignWidths()
94
+ this.setupMeasureFunc()
95
+
96
+ // Use lifecycle pass to detect line count changes BEFORE layout
97
+ this.onLifecyclePass = () => {
98
+ const currentLineCount = this.target.virtualLineCount
99
+ if (currentLineCount !== this._lastKnownLineCount) {
100
+ this._lastKnownLineCount = currentLineCount
101
+ this.yogaNode.markDirty()
102
+ this.requestRender()
103
+ }
104
+ }
105
+ }
106
+
107
+ private setupMeasureFunc(): void {
108
+ const measureFunc = (
109
+ width: number,
110
+ widthMode: MeasureMode,
111
+ height: number,
112
+ heightMode: MeasureMode,
113
+ ): { width: number; height: number } => {
114
+ // Calculate the gutter width based on the target's line count
115
+ const gutterWidth = this.calculateWidth()
116
+
117
+ // Calculate gutter height based on target's actual virtual line count
118
+ // The gutter should match the height of the content it's numbering
119
+ const gutterHeight = this.target.virtualLineCount
120
+
121
+ // Return calculated dimensions based on content, not parent constraints
122
+ return {
123
+ width: gutterWidth,
124
+ height: gutterHeight,
125
+ }
126
+ }
127
+
128
+ this.yogaNode.setMeasureFunc(measureFunc)
129
+ }
130
+
131
+ public remeasure(): void {
132
+ // Mark the yoga node as dirty to trigger re-measurement
133
+ this.yogaNode.markDirty()
134
+ }
135
+
136
+ public setLineNumberOffset(offset: number): void {
137
+ if (this._lineNumberOffset !== offset) {
138
+ this._lineNumberOffset = offset
139
+ this.yogaNode.markDirty()
140
+ this.requestRender()
141
+ }
142
+ }
143
+
144
+ public setHideLineNumbers(hideLineNumbers: Set<number>): void {
145
+ this._hideLineNumbers = hideLineNumbers
146
+ this.yogaNode.markDirty()
147
+ this.requestRender()
148
+ }
149
+
150
+ public setLineNumbers(lineNumbers: Map<number, number>): void {
151
+ this._lineNumbers = lineNumbers
152
+ this.yogaNode.markDirty()
153
+ this.requestRender()
154
+ }
155
+
156
+ private calculateSignWidths(): void {
157
+ this._maxBeforeWidth = 0
158
+ this._maxAfterWidth = 0
159
+
160
+ for (const sign of this._lineSigns.values()) {
161
+ if (sign.before) {
162
+ const width = stringWidth(sign.before)
163
+ this._maxBeforeWidth = Math.max(this._maxBeforeWidth, width)
164
+ }
165
+ if (sign.after) {
166
+ const width = stringWidth(sign.after)
167
+ this._maxAfterWidth = Math.max(this._maxAfterWidth, width)
168
+ }
169
+ }
170
+ }
171
+
172
+ private calculateWidth(): number {
173
+ const totalLines = this.target.virtualLineCount
174
+
175
+ // Find max line number, considering both calculated and custom line numbers
176
+ let maxLineNumber = totalLines + this._lineNumberOffset
177
+ if (this._lineNumbers.size > 0) {
178
+ for (const customLineNum of this._lineNumbers.values()) {
179
+ maxLineNumber = Math.max(maxLineNumber, customLineNum)
180
+ }
181
+ }
182
+
183
+ const digits = maxLineNumber > 0 ? Math.floor(Math.log10(maxLineNumber)) + 1 : 1
184
+ const baseWidth = Math.max(this._minWidth, digits + this._paddingRight + 1) // +1 for left padding
185
+ return baseWidth + this._maxBeforeWidth + this._maxAfterWidth
186
+ }
187
+
188
+ public setLineColors(lineColorsGutter: Map<number, RGBA>, lineColorsContent: Map<number, RGBA>): void {
189
+ this._lineColorsGutter = lineColorsGutter
190
+ this._lineColorsContent = lineColorsContent
191
+ this.requestRender()
192
+ }
193
+
194
+ public get fg(): RGBA {
195
+ return this._fg
196
+ }
197
+
198
+ public setFg(fg: RGBA): void {
199
+ if (this._fg !== fg) {
200
+ this._fg = fg
201
+ this.requestRender()
202
+ }
203
+ }
204
+
205
+ public get bg(): RGBA {
206
+ return this._bg
207
+ }
208
+
209
+ public setBg(bg: RGBA): void {
210
+ if (this._bg !== bg) {
211
+ this._bg = bg
212
+ this.requestRender()
213
+ }
214
+ }
215
+
216
+ public getLineColors(): { gutter: Map<number, RGBA>; content: Map<number, RGBA> } {
217
+ return {
218
+ gutter: this._lineColorsGutter,
219
+ content: this._lineColorsContent,
220
+ }
221
+ }
222
+
223
+ public setLineSigns(lineSigns: Map<number, LineSign>): void {
224
+ const oldMaxBefore = this._maxBeforeWidth
225
+ const oldMaxAfter = this._maxAfterWidth
226
+
227
+ this._lineSigns = lineSigns
228
+ this.calculateSignWidths()
229
+
230
+ // Mark dirty if sign widths changed - this will trigger remeasure
231
+ if (this._maxBeforeWidth !== oldMaxBefore || this._maxAfterWidth !== oldMaxAfter) {
232
+ this.yogaNode.markDirty()
233
+ }
234
+
235
+ // Always request render since signs themselves may have changed
236
+ this.requestRender()
237
+ }
238
+
239
+ public getLineSigns(): Map<number, LineSign> {
240
+ return this._lineSigns
241
+ }
242
+
243
+ protected renderSelf(buffer: OptimizedBuffer): void {
244
+ // For buffered rendering, only re-render when dirty OR when scroll position changed
245
+ const currentScrollY = this.target.scrollY
246
+ const scrollChanged = currentScrollY !== this._lastKnownScrollY
247
+
248
+ if (this.buffered && !this.isDirty && !scrollChanged) {
249
+ return
250
+ }
251
+
252
+ this._lastKnownScrollY = currentScrollY
253
+ this.refreshFrameBuffer(buffer)
254
+ }
255
+
256
+ private refreshFrameBuffer(buffer: OptimizedBuffer): void {
257
+ const startX = this.buffered ? 0 : this.x
258
+ const startY = this.buffered ? 0 : this.y
259
+
260
+ if (this.buffered) {
261
+ buffer.clear(this._bg)
262
+ } else if (this._bg.a > 0) {
263
+ // Fill background if not buffered and opaque (if buffered, clear handles it)
264
+ // Note: this.height might be determined by parent (flex stretch)
265
+ buffer.fillRect(startX, startY, this.width, this.height, this._bg)
266
+ }
267
+
268
+ const lineInfo = this.target.lineInfo
269
+ if (!lineInfo || !lineInfo.lineSources) return
270
+
271
+ const sources = lineInfo.lineSources
272
+ let lastSource = -1
273
+
274
+ // lineSources contains the logical line index for each visual line
275
+ // We start iterating from the scroll offset (first visible line)
276
+ const startLine = this.target.scrollY
277
+
278
+ // If scrolled past content (shouldn't happen normally but good to be safe)
279
+ if (startLine >= sources.length) return
280
+
281
+ // Get the logical line index of the line *before* the first visible line
282
+ // This helps determine if the first visible line is a wrapped continuation
283
+ lastSource = startLine > 0 ? sources[startLine - 1] : -1
284
+
285
+ for (let i = 0; i < this.height; i++) {
286
+ const visualLineIndex = startLine + i
287
+ if (visualLineIndex >= sources.length) break
288
+
289
+ const logicalLine = sources[visualLineIndex]
290
+ const lineBg = this._lineColorsGutter.get(logicalLine) ?? this._bg
291
+
292
+ // Fill background for this line if it has a custom color
293
+ if (lineBg !== this._bg) {
294
+ buffer.fillRect(startX, startY + i, this.width, 1, lineBg)
295
+ }
296
+
297
+ // Draw line number only for the first visual line of a logical line (wrapping)
298
+ if (logicalLine === lastSource) {
299
+ // Continuation line, maybe draw a dot or nothing
300
+ } else {
301
+ let currentX = startX
302
+
303
+ // Draw 'before' sign if present
304
+ const sign = this._lineSigns.get(logicalLine)
305
+ if (sign?.before) {
306
+ const beforeWidth = stringWidth(sign.before)
307
+ // Pad to max before width for alignment
308
+ const padding = this._maxBeforeWidth - beforeWidth
309
+ currentX += padding
310
+ const beforeColor = sign.beforeColor ? parseColor(sign.beforeColor) : this._fg
311
+ buffer.drawText(sign.before, currentX, startY + i, beforeColor, lineBg)
312
+ currentX += beforeWidth
313
+ } else if (this._maxBeforeWidth > 0) {
314
+ currentX += this._maxBeforeWidth
315
+ }
316
+
317
+ // Draw line number (right-aligned in its space with left padding of 1)
318
+ if (!this._hideLineNumbers.has(logicalLine)) {
319
+ // Use custom line number if provided, otherwise use calculated line number
320
+ const customLineNum = this._lineNumbers.get(logicalLine)
321
+ const lineNum = customLineNum !== undefined ? customLineNum : logicalLine + 1 + this._lineNumberOffset
322
+ const lineNumStr = lineNum.toString()
323
+ const lineNumWidth = lineNumStr.length
324
+ const availableSpace = this.width - this._maxBeforeWidth - this._maxAfterWidth - this._paddingRight
325
+ const lineNumX = startX + this._maxBeforeWidth + 1 + availableSpace - lineNumWidth - 1
326
+
327
+ if (lineNumX >= startX + this._maxBeforeWidth + 1) {
328
+ buffer.drawText(lineNumStr, lineNumX, startY + i, this._fg, lineBg)
329
+ }
330
+ }
331
+
332
+ // Draw 'after' sign if present
333
+ if (sign?.after) {
334
+ const afterX = startX + this.width - this._paddingRight - this._maxAfterWidth
335
+ const afterColor = sign.afterColor ? parseColor(sign.afterColor) : this._fg
336
+ buffer.drawText(sign.after, afterX, startY + i, afterColor, lineBg)
337
+ }
338
+ }
339
+
340
+ lastSource = logicalLine
341
+ }
342
+ }
343
+ }
344
+
345
+ // Helper function to darken an RGBA color by 20%
346
+ function darkenColor(color: RGBA): RGBA {
347
+ return RGBA.fromValues(color.r * 0.8, color.g * 0.8, color.b * 0.8, color.a)
348
+ }
349
+
350
+ export class LineNumberRenderable extends Renderable {
351
+ private gutter: GutterRenderable | null = null
352
+ private target: (Renderable & LineInfoProvider) | null = null
353
+ private _lineColorsGutter: Map<number, RGBA>
354
+ private _lineColorsContent: Map<number, RGBA>
355
+ private _lineSigns: Map<number, LineSign>
356
+ private _fg: RGBA
357
+ private _bg: RGBA
358
+ private _minWidth: number
359
+ private _paddingRight: number
360
+ private _lineNumberOffset: number
361
+ private _hideLineNumbers: Set<number>
362
+ private _lineNumbers: Map<number, number>
363
+ private _isDestroying: boolean = false
364
+ private handleLineInfoChange = (): void => {
365
+ // When line info changes in the target, remeasure the gutter
366
+ this.gutter?.remeasure()
367
+ this.requestRender()
368
+ }
369
+
370
+ private parseLineColor(line: number, color: string | RGBA | LineColorConfig): void {
371
+ if (typeof color === "object" && "gutter" in color) {
372
+ // LineColorConfig format
373
+ const config = color as LineColorConfig
374
+ if (config.gutter) {
375
+ this._lineColorsGutter.set(line, parseColor(config.gutter))
376
+ }
377
+ if (config.content) {
378
+ this._lineColorsContent.set(line, parseColor(config.content))
379
+ } else if (config.gutter) {
380
+ // If only gutter is specified, use a darker version for content
381
+ this._lineColorsContent.set(line, darkenColor(parseColor(config.gutter)))
382
+ }
383
+ } else {
384
+ // Simple format - same color for both, but content is darker
385
+ const parsedColor = parseColor(color as string | RGBA)
386
+ this._lineColorsGutter.set(line, parsedColor)
387
+ this._lineColorsContent.set(line, darkenColor(parsedColor))
388
+ }
389
+ }
390
+
391
+ constructor(ctx: RenderContext, options: LineNumberOptions) {
392
+ super(ctx, {
393
+ ...options,
394
+ flexDirection: "row",
395
+ // CRITICAL:
396
+ // By forcing height=auto, we ensure the parent box properly accounts for our full height.
397
+ height: "auto",
398
+ })
399
+
400
+ this._fg = parseColor(options.fg ?? DEFAULT_GUTTER_FG)
401
+ this._bg = parseColor(options.bg ?? DEFAULT_GUTTER_BG)
402
+ this._minWidth = options.minWidth ?? 3
403
+ this._paddingRight = options.paddingRight ?? 1
404
+ this._lineNumberOffset = options.lineNumberOffset ?? 0
405
+ this._hideLineNumbers = options.hideLineNumbers ?? new Set()
406
+ this._lineNumbers = options.lineNumbers ?? new Map()
407
+
408
+ this._lineColorsGutter = new Map<number, RGBA>()
409
+ this._lineColorsContent = new Map<number, RGBA>()
410
+ if (options.lineColors) {
411
+ for (const [line, color] of options.lineColors) {
412
+ this.parseLineColor(line, color)
413
+ }
414
+ }
415
+
416
+ this._lineSigns = new Map<number, LineSign>()
417
+ if (options.lineSigns) {
418
+ for (const [line, sign] of options.lineSigns) {
419
+ this._lineSigns.set(line, sign)
420
+ }
421
+ }
422
+
423
+ // If target is provided in constructor, set it up immediately
424
+ if (options.target) {
425
+ this.setTarget(options.target)
426
+ }
427
+ }
428
+
429
+ private setTarget(target: Renderable & LineInfoProvider): void {
430
+ if (this.target === target) return
431
+
432
+ if (this.target) {
433
+ // Remove event listener from old target
434
+ this.target.off("line-info-change", this.handleLineInfoChange)
435
+ super.remove(this.target)
436
+ }
437
+
438
+ if (this.gutter) {
439
+ super.remove(this.gutter)
440
+ this.gutter = null
441
+ }
442
+
443
+ this.target = target
444
+
445
+ // Listen for line info changes from target
446
+ this.target.on("line-info-change", this.handleLineInfoChange)
447
+
448
+ this.gutter = new GutterRenderable(this.ctx, this.target, {
449
+ fg: this._fg,
450
+ bg: this._bg,
451
+ minWidth: this._minWidth,
452
+ paddingRight: this._paddingRight,
453
+ lineColorsGutter: this._lineColorsGutter,
454
+ lineColorsContent: this._lineColorsContent,
455
+ lineSigns: this._lineSigns,
456
+ lineNumberOffset: this._lineNumberOffset,
457
+ hideLineNumbers: this._hideLineNumbers,
458
+ lineNumbers: this._lineNumbers,
459
+ id: this.id ? `${this.id}-gutter` : undefined,
460
+ buffered: true,
461
+ })
462
+
463
+ super.add(this.gutter)
464
+ super.add(this.target)
465
+ }
466
+
467
+ // Override add to intercept and set as target if it's a LineInfoProvider
468
+ public override add(child: Renderable): number {
469
+ // If this is a LineInfoProvider and we don't have a target yet, set it
470
+ if (
471
+ !this.target &&
472
+ "lineInfo" in child &&
473
+ "lineCount" in child &&
474
+ "virtualLineCount" in child &&
475
+ "scrollY" in child
476
+ ) {
477
+ this.setTarget(child as Renderable & LineInfoProvider)
478
+ return this.getChildrenCount() - 1
479
+ }
480
+ // Otherwise ignore - SolidJS may try to add layout slots or other helpers
481
+ return -1
482
+ }
483
+
484
+ // Override remove to prevent removing gutter/target directly
485
+ public override remove(child: BaseRenderable): void {
486
+ if (this._isDestroying) {
487
+ super.remove(child)
488
+ return
489
+ }
490
+
491
+ if (this.gutter && child === this.gutter) {
492
+ throw new Error("LineNumberRenderable: Cannot remove gutter directly.")
493
+ }
494
+ if (this.target && child === this.target) {
495
+ throw new Error("LineNumberRenderable: Cannot remove target directly. Use clearTarget() instead.")
496
+ }
497
+ super.remove(child)
498
+ }
499
+
500
+ // Override destroyRecursively to properly clean up internal components
501
+ public override destroyRecursively(): void {
502
+ this._isDestroying = true
503
+
504
+ if (this.target) {
505
+ this.target.off("line-info-change", this.handleLineInfoChange)
506
+ }
507
+
508
+ super.destroyRecursively()
509
+
510
+ this.gutter = null
511
+ this.target = null
512
+ }
513
+
514
+ public clearTarget(): void {
515
+ if (this.target) {
516
+ this.target.off("line-info-change", this.handleLineInfoChange)
517
+ super.remove(this.target)
518
+ this.target = null
519
+ }
520
+ if (this.gutter) {
521
+ super.remove(this.gutter)
522
+ this.gutter = null
523
+ }
524
+ }
525
+
526
+ protected renderSelf(buffer: OptimizedBuffer): void {
527
+ // Draw full-width line backgrounds before children render
528
+ if (!this.target || !this.gutter) return
529
+
530
+ const lineInfo = this.target.lineInfo
531
+ if (!lineInfo || !lineInfo.lineSources) return
532
+
533
+ const sources = lineInfo.lineSources
534
+ const startLine = this.target.scrollY
535
+
536
+ if (startLine >= sources.length) return
537
+
538
+ // Calculate the area to fill: from after the gutter (if visible) to the end of our width
539
+ const gutterWidth = this.gutter.visible ? this.gutter.width : 0
540
+ const contentWidth = this.width - gutterWidth
541
+
542
+ // Draw full-width background colors for lines with custom colors
543
+ for (let i = 0; i < this.height; i++) {
544
+ const visualLineIndex = startLine + i
545
+ if (visualLineIndex >= sources.length) break
546
+
547
+ const logicalLine = sources[visualLineIndex]
548
+ const lineBg = this._lineColorsContent.get(logicalLine)
549
+
550
+ if (lineBg) {
551
+ // Fill from after gutter to the end of the LineNumberRenderable
552
+ buffer.fillRect(this.x + gutterWidth, this.y + i, contentWidth, 1, lineBg)
553
+ }
554
+ }
555
+ }
556
+
557
+ public set showLineNumbers(value: boolean) {
558
+ if (this.gutter) {
559
+ this.gutter.visible = value
560
+ }
561
+ }
562
+
563
+ public get showLineNumbers(): boolean {
564
+ return this.gutter?.visible ?? false
565
+ }
566
+
567
+ public get fg(): RGBA {
568
+ return this._fg
569
+ }
570
+
571
+ public set fg(value: string | RGBA | undefined) {
572
+ const parsed = parseColor(value ?? DEFAULT_GUTTER_FG)
573
+ if (this._fg !== parsed) {
574
+ this._fg = parsed
575
+ this.gutter?.setFg(parsed)
576
+ }
577
+ }
578
+
579
+ public get bg(): RGBA {
580
+ return this._bg
581
+ }
582
+
583
+ public set bg(value: string | RGBA | undefined) {
584
+ const parsed = parseColor(value ?? DEFAULT_GUTTER_BG)
585
+ if (this._bg !== parsed) {
586
+ this._bg = parsed
587
+ this.gutter?.setBg(parsed)
588
+ }
589
+ }
590
+
591
+ public setLineColor(line: number, color: string | RGBA | LineColorConfig): void {
592
+ this.parseLineColor(line, color)
593
+ // Update gutter if it exists
594
+ if (this.gutter) {
595
+ this.gutter.setLineColors(this._lineColorsGutter, this._lineColorsContent)
596
+ }
597
+ }
598
+
599
+ public clearLineColor(line: number): void {
600
+ this._lineColorsGutter.delete(line)
601
+ this._lineColorsContent.delete(line)
602
+ if (this.gutter) {
603
+ this.gutter.setLineColors(this._lineColorsGutter, this._lineColorsContent)
604
+ }
605
+ }
606
+
607
+ public clearAllLineColors(): void {
608
+ this._lineColorsGutter.clear()
609
+ this._lineColorsContent.clear()
610
+ if (this.gutter) {
611
+ this.gutter.setLineColors(this._lineColorsGutter, this._lineColorsContent)
612
+ }
613
+ }
614
+
615
+ public setLineColors(lineColors: Map<number, string | RGBA | LineColorConfig>): void {
616
+ this._lineColorsGutter.clear()
617
+ this._lineColorsContent.clear()
618
+ for (const [line, color] of lineColors) {
619
+ this.parseLineColor(line, color)
620
+ }
621
+ // Update gutter once after all colors are set
622
+ if (this.gutter) {
623
+ this.gutter.setLineColors(this._lineColorsGutter, this._lineColorsContent)
624
+ }
625
+ }
626
+
627
+ public getLineColors(): { gutter: Map<number, RGBA>; content: Map<number, RGBA> } {
628
+ return {
629
+ gutter: this._lineColorsGutter,
630
+ content: this._lineColorsContent,
631
+ }
632
+ }
633
+
634
+ public setLineSign(line: number, sign: LineSign): void {
635
+ this._lineSigns.set(line, sign)
636
+ if (this.gutter) {
637
+ this.gutter.setLineSigns(this._lineSigns)
638
+ }
639
+ }
640
+
641
+ public clearLineSign(line: number): void {
642
+ this._lineSigns.delete(line)
643
+ if (this.gutter) {
644
+ this.gutter.setLineSigns(this._lineSigns)
645
+ }
646
+ }
647
+
648
+ public clearAllLineSigns(): void {
649
+ this._lineSigns.clear()
650
+ if (this.gutter) {
651
+ this.gutter.setLineSigns(this._lineSigns)
652
+ }
653
+ }
654
+
655
+ public setLineSigns(lineSigns: Map<number, LineSign>): void {
656
+ this._lineSigns.clear()
657
+ for (const [line, sign] of lineSigns) {
658
+ this._lineSigns.set(line, sign)
659
+ }
660
+ if (this.gutter) {
661
+ this.gutter.setLineSigns(this._lineSigns)
662
+ }
663
+ }
664
+
665
+ public getLineSigns(): Map<number, LineSign> {
666
+ return this._lineSigns
667
+ }
668
+
669
+ public set lineNumberOffset(value: number) {
670
+ if (this._lineNumberOffset !== value) {
671
+ this._lineNumberOffset = value
672
+ if (this.gutter) {
673
+ // Update the gutter's offset using its setter
674
+ this.gutter.setLineNumberOffset(value)
675
+ }
676
+ }
677
+ }
678
+
679
+ public get lineNumberOffset(): number {
680
+ return this._lineNumberOffset
681
+ }
682
+
683
+ public setHideLineNumbers(hideLineNumbers: Set<number>): void {
684
+ this._hideLineNumbers = hideLineNumbers
685
+ if (this.gutter) {
686
+ // Update the gutter's hideLineNumbers using its setter
687
+ this.gutter.setHideLineNumbers(hideLineNumbers)
688
+ }
689
+ }
690
+
691
+ public getHideLineNumbers(): Set<number> {
692
+ return this._hideLineNumbers
693
+ }
694
+
695
+ public setLineNumbers(lineNumbers: Map<number, number>): void {
696
+ this._lineNumbers = lineNumbers
697
+ if (this.gutter) {
698
+ // Update the gutter's lineNumbers using its setter
699
+ this.gutter.setLineNumbers(lineNumbers)
700
+ }
701
+ }
702
+
703
+ public getLineNumbers(): Map<number, number> {
704
+ return this._lineNumbers
705
+ }
706
+
707
+ public highlightLines(startLine: number, endLine: number, color: string | RGBA | LineColorConfig): void {
708
+ for (let i = startLine; i <= endLine; i++) {
709
+ this.parseLineColor(i, color)
710
+ }
711
+ if (this.gutter) {
712
+ this.gutter.setLineColors(this._lineColorsGutter, this._lineColorsContent)
713
+ }
714
+ }
715
+
716
+ public clearHighlightLines(startLine: number, endLine: number): void {
717
+ for (let i = startLine; i <= endLine; i++) {
718
+ this._lineColorsGutter.delete(i)
719
+ this._lineColorsContent.delete(i)
720
+ }
721
+ if (this.gutter) {
722
+ this.gutter.setLineColors(this._lineColorsGutter, this._lineColorsContent)
723
+ }
724
+ }
725
+ }