@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,1111 @@
1
+ const std = @import("std");
2
+ const buffer_mod = @import("../buffer.zig");
3
+ const buffer_effects = @import("../buffer-methods.zig");
4
+ const ansi = @import("../ansi.zig");
5
+ const gp = @import("../grapheme.zig");
6
+
7
+ const OptimizedBuffer = buffer_mod.OptimizedBuffer;
8
+ const RGBA = buffer_mod.RGBA;
9
+ const ColorTarget = buffer_effects.ColorTarget;
10
+
11
+ fn expectRGBAApprox(expected: RGBA, actual: RGBA, epsilon: f32) !void {
12
+ const diff_r = @abs(ansi.redF(expected) - ansi.redF(actual));
13
+ const diff_g = @abs(ansi.greenF(expected) - ansi.greenF(actual));
14
+ const diff_b = @abs(ansi.blueF(expected) - ansi.blueF(actual));
15
+ const diff_a = @abs(ansi.alphaF(expected) - ansi.alphaF(actual));
16
+ const tolerance = epsilon + (1.0 / 255.0);
17
+
18
+ if (diff_r > tolerance or diff_g > tolerance or diff_b > tolerance or diff_a > tolerance) {
19
+ std.debug.print("RGBA mismatch: expected {any}, got {any}\n", .{ expected, actual });
20
+ return error.TestExpectedApprox;
21
+ }
22
+ }
23
+
24
+ fn expectVec4fApprox(expected: @Vector(4, f32), actual: @Vector(4, f32), epsilon: f32) !void {
25
+ const diff = @abs(expected - actual);
26
+ if (@reduce(.Or, diff > @as(@Vector(4, f32), @splat(epsilon)))) {
27
+ std.debug.print("Vec4 mismatch: expected {any}, got {any}\n", .{ expected, actual });
28
+ return error.TestExpectedApprox;
29
+ }
30
+ }
31
+
32
+ // Identity matrix (no change)
33
+ const IDENTITY_MATRIX = [16]f32{
34
+ 1.0, 0.0, 0.0, 0.0, // Red output
35
+ 0.0, 1.0, 0.0, 0.0, // Green output
36
+ 0.0, 0.0, 1.0, 0.0, // Blue output
37
+ 0.0, 0.0, 0.0, 1.0, // Alpha output
38
+ };
39
+
40
+ // Sepia matrix
41
+ const SEPIA_MATRIX = [16]f32{
42
+ 0.393, 0.769, 0.189, 0.0, // Red output
43
+ 0.349, 0.686, 0.168, 0.0, // Green output
44
+ 0.272, 0.534, 0.131, 0.0, // Blue output
45
+ 0.0, 0.0, 0.0, 1.0, // Alpha output
46
+ };
47
+
48
+ // Grayscale matrix (luminance)
49
+ const GRAYSCALE_MATRIX = [16]f32{
50
+ 0.299, 0.587, 0.114, 0.0, // Red output
51
+ 0.299, 0.587, 0.114, 0.0, // Green output
52
+ 0.299, 0.587, 0.114, 0.0, // Blue output
53
+ 0.0, 0.0, 0.0, 1.0, // Alpha output
54
+ };
55
+
56
+ // Invert matrix
57
+ const INVERT_MATRIX = [16]f32{
58
+ -1.0, 0.0, 0.0, 0.0, // Red output
59
+ 0.0, -1.0, 0.0, 0.0, // Green output
60
+ 0.0, 0.0, -1.0, 0.0, // Blue output
61
+ 0.0, 0.0, 0.0, 1.0, // Alpha output
62
+ };
63
+
64
+ test "colorMatrix - identity matrix leaves colors unchanged" {
65
+ const pool = gp.initGlobalPool(std.testing.allocator);
66
+ defer gp.deinitGlobalPool();
67
+
68
+ var buf = try OptimizedBuffer.init(
69
+ std.testing.allocator,
70
+ 4,
71
+ 4,
72
+ .{ .pool = pool, .id = "test-buffer" },
73
+ );
74
+ defer buf.deinit();
75
+
76
+ const bg = ansi.rgbaFromFloats(0.0, 0.0, 0.0, 1.0);
77
+ const red = ansi.rgbaFromFloats(1.0, 0.0, 0.0, 1.0);
78
+
79
+ buf.clear(bg, null);
80
+ buf.buffer.fg[0] = red; // (0, 0)
81
+ buf.buffer.fg[5] = red; // (1, 1)
82
+
83
+ // Apply identity to specific cells: (0, 0) and (1, 1) with strength 1.0
84
+ // cellMask format: [x, y, strength, x, y, strength, ...]
85
+ const cell_mask = [_]f32{ 0.0, 0.0, 1.0, 1.0, 1.0, 1.0 };
86
+ buffer_effects.colorMatrix(buf, &IDENTITY_MATRIX, &cell_mask, 1.0, ColorTarget.FG); // target=1 (FG)
87
+
88
+ // Colors should be unchanged
89
+ try expectRGBAApprox(red, buf.buffer.fg[0], 0.0001);
90
+ try expectRGBAApprox(red, buf.buffer.fg[5], 0.0001);
91
+ }
92
+
93
+ test "colorMatrix - applies transformation to specified cells only" {
94
+ const pool = gp.initGlobalPool(std.testing.allocator);
95
+ defer gp.deinitGlobalPool();
96
+
97
+ var buf = try OptimizedBuffer.init(
98
+ std.testing.allocator,
99
+ 3,
100
+ 3,
101
+ .{ .pool = pool, .id = "test-buffer" },
102
+ );
103
+ defer buf.deinit();
104
+
105
+ const bg = ansi.rgbaFromFloats(0.0, 0.0, 0.0, 1.0);
106
+ const red = ansi.rgbaFromFloats(1.0, 0.0, 0.0, 1.0);
107
+
108
+ buf.clear(bg, null);
109
+
110
+ // Set all FG to red
111
+ @memset(buf.buffer.fg, red);
112
+
113
+ // Apply sepia only to cell (1, 1) with full strength
114
+ const cell_mask = [_]f32{ 1.0, 1.0, 1.0 };
115
+ buffer_effects.colorMatrix(buf, &SEPIA_MATRIX, &cell_mask, 1.0, ColorTarget.FG);
116
+
117
+ // Cell (1, 1) should be transformed (index = y * width + x = 1 * 3 + 1 = 4)
118
+ const expected_r = 0.393;
119
+ const expected_g = 0.349;
120
+ const expected_b = 0.272;
121
+ try expectRGBAApprox(ansi.rgbaFromFloats(expected_r, expected_g, expected_b, 1.0), buf.buffer.fg[4], 0.001);
122
+
123
+ // Other cells should remain red
124
+ try expectRGBAApprox(red, buf.buffer.fg[0], 0.0001); // (0, 0)
125
+ try expectRGBAApprox(red, buf.buffer.fg[8], 0.0001); // (2, 2)
126
+ }
127
+
128
+ test "colorMatrix - globalStrength scales individual cell strengths" {
129
+ const pool = gp.initGlobalPool(std.testing.allocator);
130
+ defer gp.deinitGlobalPool();
131
+
132
+ var buf = try OptimizedBuffer.init(
133
+ std.testing.allocator,
134
+ 2,
135
+ 1,
136
+ .{ .pool = pool, .id = "test-buffer" },
137
+ );
138
+ defer buf.deinit();
139
+
140
+ const bg = ansi.rgbaFromFloats(0.0, 0.0, 0.0, 1.0);
141
+ const red = ansi.rgbaFromFloats(1.0, 0.0, 0.0, 1.0);
142
+
143
+ buf.clear(bg, null);
144
+ buf.buffer.fg[0] = red;
145
+
146
+ // Apply sepia with cell strength 1.0 but globalStrength 0.5
147
+ const cell_mask = [_]f32{ 0.0, 0.0, 1.0 };
148
+ buffer_effects.colorMatrix(buf, &SEPIA_MATRIX, &cell_mask, 0.5, ColorTarget.FG);
149
+
150
+ // Expected: blend(original, sepia, 0.5)
151
+ const sepia_r = 0.393;
152
+ const expected_r = 1.0 + (sepia_r - 1.0) * 0.5;
153
+ const sepia_g = 0.349;
154
+ const expected_g = 0.0 + (sepia_g - 0.0) * 0.5;
155
+ const sepia_b = 0.272;
156
+ const expected_b = 0.0 + (sepia_b - 0.0) * 0.5;
157
+
158
+ try expectRGBAApprox(ansi.rgbaFromFloats(expected_r, expected_g, expected_b, 1.0), buf.buffer.fg[0], 0.001);
159
+ }
160
+
161
+ test "colorMatrix - respects target parameter" {
162
+ const pool = gp.initGlobalPool(std.testing.allocator);
163
+ defer gp.deinitGlobalPool();
164
+
165
+ var buf = try OptimizedBuffer.init(
166
+ std.testing.allocator,
167
+ 2,
168
+ 1,
169
+ .{ .pool = pool, .id = "test-buffer" },
170
+ );
171
+ defer buf.deinit();
172
+
173
+ const bg = ansi.rgbaFromFloats(0.0, 0.0, 0.0, 1.0);
174
+ const red = ansi.rgbaFromFloats(1.0, 0.0, 0.0, 1.0);
175
+ const blue = ansi.rgbaFromFloats(0.0, 0.0, 1.0, 1.0);
176
+
177
+ buf.clear(bg, null);
178
+ buf.buffer.fg[0] = red;
179
+ buf.buffer.bg[0] = blue;
180
+ buf.buffer.fg[1] = red;
181
+ buf.buffer.bg[1] = blue;
182
+
183
+ // Apply to FG only (target = 1)
184
+ const cell_mask = [_]f32{ 0.0, 0.0, 1.0 };
185
+ buffer_effects.colorMatrix(buf, &GRAYSCALE_MATRIX, &cell_mask, 1.0, ColorTarget.FG);
186
+
187
+ // FG should be grayscale, BG should remain blue
188
+ const gray_red = 0.299 * 1.0;
189
+ try expectRGBAApprox(ansi.rgbaFromFloats(gray_red, gray_red, gray_red, 1.0), buf.buffer.fg[0], 0.001);
190
+ try expectRGBAApprox(blue, buf.buffer.bg[0], 0.0001);
191
+
192
+ // Reset for BG test
193
+ buf.buffer.fg[0] = red;
194
+ buf.buffer.bg[0] = blue;
195
+ buf.buffer.fg[1] = red;
196
+ buf.buffer.bg[1] = blue;
197
+
198
+ buffer_effects.colorMatrix(buf, &GRAYSCALE_MATRIX, &cell_mask, 1.0, ColorTarget.BG); // target=2 (BG)
199
+
200
+ // BG should be grayscale, FG should remain red
201
+ const gray_blue = 0.114 * 1.0;
202
+ try expectRGBAApprox(red, buf.buffer.fg[0], 0.0001);
203
+ try expectRGBAApprox(ansi.rgbaFromFloats(gray_blue, gray_blue, gray_blue, 1.0), buf.buffer.bg[0], 0.001);
204
+ }
205
+
206
+ test "colorMatrix - skips out-of-bounds coordinates" {
207
+ const pool = gp.initGlobalPool(std.testing.allocator);
208
+ defer gp.deinitGlobalPool();
209
+
210
+ var buf = try OptimizedBuffer.init(
211
+ std.testing.allocator,
212
+ 3,
213
+ 3,
214
+ .{ .pool = pool, .id = "test-buffer" },
215
+ );
216
+ defer buf.deinit();
217
+
218
+ const bg = ansi.rgbaFromFloats(0.0, 0.0, 0.0, 1.0);
219
+ const red = ansi.rgbaFromFloats(1.0, 0.0, 0.0, 1.0);
220
+
221
+ buf.clear(bg, null);
222
+ buf.buffer.fg[4] = red; // (1, 1)
223
+
224
+ // Apply to out-of-bounds and valid cell
225
+ const cell_mask = [_]f32{ 10.0, 10.0, 1.0, 1.0, 1.0, 1.0 }; // (10, 10) is OOB
226
+ buffer_effects.colorMatrix(buf, &SEPIA_MATRIX, &cell_mask, 1.0, ColorTarget.FG);
227
+
228
+ // Valid cell should be transformed
229
+ const expected_r = 0.393;
230
+ const expected_g = 0.349;
231
+ const expected_b = 0.272;
232
+ try expectRGBAApprox(ansi.rgbaFromFloats(expected_r, expected_g, expected_b, 1.0), buf.buffer.fg[4], 0.001);
233
+ }
234
+
235
+ test "colorMatrix - skips NaN and Inf coordinates" {
236
+ const pool = gp.initGlobalPool(std.testing.allocator);
237
+ defer gp.deinitGlobalPool();
238
+
239
+ var buf = try OptimizedBuffer.init(
240
+ std.testing.allocator,
241
+ 3,
242
+ 3,
243
+ .{ .pool = pool, .id = "test-buffer" },
244
+ );
245
+ defer buf.deinit();
246
+
247
+ const bg = ansi.rgbaFromFloats(0.0, 0.0, 0.0, 1.0);
248
+ const red = ansi.rgbaFromFloats(1.0, 0.0, 0.0, 1.0);
249
+
250
+ buf.clear(bg, null);
251
+ buf.buffer.fg[4] = red; // (1, 1)
252
+
253
+ // Apply with NaN and valid coordinates
254
+ const nan = std.math.nan(f32);
255
+ const cell_mask = [_]f32{ nan, 1.0, 1.0, 1.0, 1.0, 1.0 };
256
+ buffer_effects.colorMatrix(buf, &SEPIA_MATRIX, &cell_mask, 1.0, ColorTarget.FG);
257
+
258
+ // Valid cell should be transformed
259
+ const expected_r = 0.393;
260
+ const expected_g = 0.349;
261
+ const expected_b = 0.272;
262
+ try expectRGBAApprox(ansi.rgbaFromFloats(expected_r, expected_g, expected_b, 1.0), buf.buffer.fg[4], 0.001);
263
+ }
264
+
265
+ test "colorMatrix - skips zero strength cells" {
266
+ const pool = gp.initGlobalPool(std.testing.allocator);
267
+ defer gp.deinitGlobalPool();
268
+
269
+ var buf = try OptimizedBuffer.init(
270
+ std.testing.allocator,
271
+ 2,
272
+ 1,
273
+ .{ .pool = pool, .id = "test-buffer" },
274
+ );
275
+ defer buf.deinit();
276
+
277
+ const bg = ansi.rgbaFromFloats(0.0, 0.0, 0.0, 1.0);
278
+ const red = ansi.rgbaFromFloats(1.0, 0.0, 0.0, 1.0);
279
+
280
+ buf.clear(bg, null);
281
+ buf.buffer.fg[0] = red;
282
+
283
+ // Apply with zero strength
284
+ const cell_mask = [_]f32{ 0.0, 0.0, 0.0 };
285
+ buffer_effects.colorMatrix(buf, &SEPIA_MATRIX, &cell_mask, 1.0, ColorTarget.FG);
286
+
287
+ // Color should be unchanged
288
+ try expectRGBAApprox(red, buf.buffer.fg[0], 0.0001);
289
+ }
290
+
291
+ test "colorMatrix - handles multiple cells in mask" {
292
+ const pool = gp.initGlobalPool(std.testing.allocator);
293
+ defer gp.deinitGlobalPool();
294
+
295
+ var buf = try OptimizedBuffer.init(
296
+ std.testing.allocator,
297
+ 4,
298
+ 4,
299
+ .{ .pool = pool, .id = "test-buffer" },
300
+ );
301
+ defer buf.deinit();
302
+
303
+ const bg = ansi.rgbaFromFloats(0.0, 0.0, 0.0, 1.0);
304
+ const red = ansi.rgbaFromFloats(1.0, 0.0, 0.0, 1.0);
305
+ const green = ansi.rgbaFromFloats(0.0, 1.0, 0.0, 1.0);
306
+ const blue = ansi.rgbaFromFloats(0.0, 0.0, 1.0, 1.0);
307
+ const white = ansi.rgbaFromFloats(1.0, 1.0, 1.0, 1.0);
308
+
309
+ buf.clear(bg, null);
310
+
311
+ // Set different colors at different positions
312
+ buf.buffer.fg[0] = red; // (0, 0)
313
+ buf.buffer.fg[5] = green; // (1, 1)
314
+ buf.buffer.fg[10] = blue; // (2, 2)
315
+ buf.buffer.fg[15] = white; // (3, 3)
316
+
317
+ // Apply sepia to all four cells with varying strengths
318
+ const cell_mask = [_]f32{
319
+ 0.0, 0.0, 1.0, // (0, 0) - full
320
+ 1.0, 1.0, 0.5, // (1, 1) - half
321
+ 2.0, 2.0, 0.0, // (2, 2) - none (skipped)
322
+ 3.0, 3.0, 1.0, // (3, 3) - full
323
+ };
324
+ buffer_effects.colorMatrix(buf, &SEPIA_MATRIX, &cell_mask, 1.0, ColorTarget.FG);
325
+
326
+ // (0, 0) should be fully sepia
327
+ const sepia_r = 0.393;
328
+ const sepia_g = 0.349;
329
+ const sepia_b = 0.272;
330
+ try expectRGBAApprox(ansi.rgbaFromFloats(sepia_r, sepia_g, sepia_b, 1.0), buf.buffer.fg[0], 0.001);
331
+
332
+ // (1, 1) should be half sepia
333
+ const green_sepia_r = 0.0 + (0.769 - 0.0) * 0.5; // Matrix row 0, col 1 = 0.769
334
+ const green_sepia_g = 1.0 + (0.686 - 1.0) * 0.5;
335
+ const green_sepia_b = 0.0 + (0.534 - 0.0) * 0.5;
336
+ try expectRGBAApprox(ansi.rgbaFromFloats(green_sepia_r, green_sepia_g, green_sepia_b, 1.0), buf.buffer.fg[5], 0.001);
337
+
338
+ // (2, 2) should be unchanged (zero strength)
339
+ try expectRGBAApprox(blue, buf.buffer.fg[10], 0.0001);
340
+
341
+ // (3, 3) should be fully sepia of white
342
+ // White * sepia matrix = sum of first 3 columns of each row
343
+ const white_sepia_r = 0.393 + 0.769 + 0.189; // ~1.351
344
+ const white_sepia_g = 0.349 + 0.686 + 0.168; // ~1.203
345
+ const white_sepia_b = 0.272 + 0.534 + 0.131; // ~0.937
346
+ try expectRGBAApprox(ansi.rgbaFromFloats(white_sepia_r, white_sepia_g, white_sepia_b, 1.0), buf.buffer.fg[15], 0.001);
347
+ }
348
+
349
+ test "colorMatrix - truncates incomplete mask triplets" {
350
+ const pool = gp.initGlobalPool(std.testing.allocator);
351
+ defer gp.deinitGlobalPool();
352
+
353
+ var buf = try OptimizedBuffer.init(
354
+ std.testing.allocator,
355
+ 3,
356
+ 1,
357
+ .{ .pool = pool, .id = "test-buffer" },
358
+ );
359
+ defer buf.deinit();
360
+
361
+ const bg = ansi.rgbaFromFloats(0.0, 0.0, 0.0, 1.0);
362
+ const red = ansi.rgbaFromFloats(1.0, 0.0, 0.0, 1.0);
363
+
364
+ buf.clear(bg, null);
365
+ buf.buffer.fg[0] = red;
366
+ buf.buffer.fg[1] = red;
367
+
368
+ // Mask with 5 elements (1 complete triplet + 2 incomplete)
369
+ const cell_mask = [_]f32{ 0.0, 0.0, 1.0, 1.0, 1.0 };
370
+ buffer_effects.colorMatrix(buf, &SEPIA_MATRIX, &cell_mask, 1.0, ColorTarget.FG);
371
+
372
+ // Only first cell should be transformed
373
+ const sepia_r = 0.393;
374
+ const sepia_g = 0.349;
375
+ const sepia_b = 0.272;
376
+ try expectRGBAApprox(ansi.rgbaFromFloats(sepia_r, sepia_g, sepia_b, 1.0), buf.buffer.fg[0], 0.001);
377
+
378
+ // Second cell should be unchanged (incomplete triplet ignored)
379
+ try expectRGBAApprox(red, buf.buffer.fg[1], 0.0001);
380
+ }
381
+
382
+ test "colorMatrix - empty mask returns early" {
383
+ const pool = gp.initGlobalPool(std.testing.allocator);
384
+ defer gp.deinitGlobalPool();
385
+
386
+ var buf = try OptimizedBuffer.init(
387
+ std.testing.allocator,
388
+ 2,
389
+ 1,
390
+ .{ .pool = pool, .id = "test-buffer" },
391
+ );
392
+ defer buf.deinit();
393
+
394
+ const bg = ansi.rgbaFromFloats(0.0, 0.0, 0.0, 1.0);
395
+ const red = ansi.rgbaFromFloats(1.0, 0.0, 0.0, 1.0);
396
+
397
+ buf.clear(bg, null);
398
+ buf.buffer.fg[0] = red;
399
+
400
+ // Empty mask - should return early
401
+ const empty_mask: [0]f32 = .{};
402
+ buffer_effects.colorMatrix(buf, &SEPIA_MATRIX, &empty_mask, 1.0, ColorTarget.FG);
403
+
404
+ // Color should be unchanged
405
+ try expectRGBAApprox(red, buf.buffer.fg[0], 0.0001);
406
+ }
407
+
408
+ test "colorMatrix - empty matrix returns early" {
409
+ const pool = gp.initGlobalPool(std.testing.allocator);
410
+ defer gp.deinitGlobalPool();
411
+
412
+ var buf = try OptimizedBuffer.init(
413
+ std.testing.allocator,
414
+ 2,
415
+ 1,
416
+ .{ .pool = pool, .id = "test-buffer" },
417
+ );
418
+ defer buf.deinit();
419
+
420
+ const bg = ansi.rgbaFromFloats(0.0, 0.0, 0.0, 1.0);
421
+ const red = ansi.rgbaFromFloats(1.0, 0.0, 0.0, 1.0);
422
+
423
+ buf.clear(bg, null);
424
+ buf.buffer.fg[0] = red;
425
+
426
+ // Empty matrix - should return early
427
+ const empty_matrix: [0]f32 = .{};
428
+ const cell_mask = [_]f32{ 0.0, 0.0, 1.0 };
429
+ buffer_effects.colorMatrix(buf, &empty_matrix, &cell_mask, 1.0, ColorTarget.FG);
430
+
431
+ // Color should be unchanged
432
+ try expectRGBAApprox(red, buf.buffer.fg[0], 0.0001);
433
+ }
434
+
435
+ // Test matrix that modifies alpha channel
436
+ const ALPHA_MODIFY_MATRIX = [16]f32{
437
+ 1.0, 0.0, 0.0, 0.0, // Red output
438
+ 0.0, 1.0, 0.0, 0.0, // Green output
439
+ 0.0, 0.0, 1.0, 0.0, // Blue output
440
+ 0.0, 0.0, 0.0, 0.5, // Alpha output (multiply by 0.5)
441
+ };
442
+
443
+ test "colorMatrix - alpha channel transformation" {
444
+ const pool = gp.initGlobalPool(std.testing.allocator);
445
+ defer gp.deinitGlobalPool();
446
+
447
+ var buf = try OptimizedBuffer.init(
448
+ std.testing.allocator,
449
+ 2,
450
+ 1,
451
+ .{ .pool = pool, .id = "test-buffer" },
452
+ );
453
+ defer buf.deinit();
454
+
455
+ const bg = ansi.rgbaFromFloats(0.0, 0.0, 0.0, 1.0);
456
+ const opaque_color = ansi.rgbaFromFloats(1.0, 0.0, 0.0, 1.0);
457
+
458
+ buf.clear(bg, null);
459
+ buf.buffer.fg[0] = opaque_color;
460
+
461
+ // Apply matrix that halves alpha
462
+ const cell_mask = [_]f32{ 0.0, 0.0, 1.0 };
463
+ buffer_effects.colorMatrix(buf, &ALPHA_MODIFY_MATRIX, &cell_mask, 1.0, ColorTarget.FG);
464
+
465
+ // Alpha should be halved
466
+ try expectRGBAApprox(ansi.rgbaFromFloats(1.0, 0.0, 0.0, 0.5), buf.buffer.fg[0], 0.0001);
467
+ }
468
+
469
+ test "colorMatrix - mask with only 1 element" {
470
+ const pool = gp.initGlobalPool(std.testing.allocator);
471
+ defer gp.deinitGlobalPool();
472
+
473
+ var buf = try OptimizedBuffer.init(
474
+ std.testing.allocator,
475
+ 2,
476
+ 1,
477
+ .{ .pool = pool, .id = "test-buffer" },
478
+ );
479
+ defer buf.deinit();
480
+
481
+ const bg = ansi.rgbaFromFloats(0.0, 0.0, 0.0, 1.0);
482
+ const red = ansi.rgbaFromFloats(1.0, 0.0, 0.0, 1.0);
483
+
484
+ buf.clear(bg, null);
485
+ buf.buffer.fg[0] = red;
486
+
487
+ // Mask with only 1 element (incomplete triplet)
488
+ const cell_mask = [_]f32{0.0};
489
+ buffer_effects.colorMatrix(buf, &SEPIA_MATRIX, &cell_mask, 1.0, ColorTarget.FG);
490
+
491
+ // Color should be unchanged (no complete triplets to process)
492
+ try expectRGBAApprox(red, buf.buffer.fg[0], 0.0001);
493
+ }
494
+
495
+ test "colorMatrix - mask with only 2 elements" {
496
+ const pool = gp.initGlobalPool(std.testing.allocator);
497
+ defer gp.deinitGlobalPool();
498
+
499
+ var buf = try OptimizedBuffer.init(
500
+ std.testing.allocator,
501
+ 2,
502
+ 1,
503
+ .{ .pool = pool, .id = "test-buffer" },
504
+ );
505
+ defer buf.deinit();
506
+
507
+ const bg = ansi.rgbaFromFloats(0.0, 0.0, 0.0, 1.0);
508
+ const red = ansi.rgbaFromFloats(1.0, 0.0, 0.0, 1.0);
509
+
510
+ buf.clear(bg, null);
511
+ buf.buffer.fg[0] = red;
512
+ buf.buffer.fg[1] = red;
513
+
514
+ // Mask with only 2 elements (incomplete triplet)
515
+ const cell_mask = [_]f32{ 0.0, 0.0 };
516
+ buffer_effects.colorMatrix(buf, &SEPIA_MATRIX, &cell_mask, 1.0, ColorTarget.FG);
517
+
518
+ // Colors should be unchanged (no complete triplets to process)
519
+ try expectRGBAApprox(red, buf.buffer.fg[0], 0.0001);
520
+ try expectRGBAApprox(red, buf.buffer.fg[1], 0.0001);
521
+ }
522
+
523
+ test "colorMatrix - infinity strength is skipped" {
524
+ const pool = gp.initGlobalPool(std.testing.allocator);
525
+ defer gp.deinitGlobalPool();
526
+
527
+ var buf = try OptimizedBuffer.init(
528
+ std.testing.allocator,
529
+ 2,
530
+ 1,
531
+ .{ .pool = pool, .id = "test-buffer" },
532
+ );
533
+ defer buf.deinit();
534
+
535
+ const bg = ansi.rgbaFromFloats(0.0, 0.0, 0.0, 1.0);
536
+ const red = ansi.rgbaFromFloats(1.0, 0.0, 0.0, 1.0);
537
+
538
+ buf.clear(bg, null);
539
+ buf.buffer.fg[0] = red;
540
+
541
+ // Apply with infinity strength (should be skipped)
542
+ const inf = std.math.inf(f32);
543
+ const cell_mask = [_]f32{ 0.0, 0.0, inf };
544
+ buffer_effects.colorMatrix(buf, &SEPIA_MATRIX, &cell_mask, 1.0, ColorTarget.FG);
545
+
546
+ // Color should be unchanged
547
+ try expectRGBAApprox(red, buf.buffer.fg[0], 0.0001);
548
+ }
549
+
550
+ test "colorMatrix - non-finite global strength is skipped" {
551
+ const pool = gp.initGlobalPool(std.testing.allocator);
552
+ defer gp.deinitGlobalPool();
553
+
554
+ var buf = try OptimizedBuffer.init(
555
+ std.testing.allocator,
556
+ 2,
557
+ 1,
558
+ .{ .pool = pool, .id = "test-buffer" },
559
+ );
560
+ defer buf.deinit();
561
+
562
+ const bg = ansi.rgbaFromFloats(0.0, 0.0, 0.0, 1.0);
563
+ const red = ansi.rgbaFromFloats(1.0, 0.0, 0.0, 1.0);
564
+
565
+ buf.clear(bg, null);
566
+ buf.buffer.fg[0] = red;
567
+
568
+ const inf = std.math.inf(f32);
569
+ const cell_mask = [_]f32{ 0.0, 0.0, 1.0 };
570
+ buffer_effects.colorMatrix(buf, &SEPIA_MATRIX, &cell_mask, inf, ColorTarget.FG);
571
+
572
+ // Color should be unchanged
573
+ try expectRGBAApprox(red, buf.buffer.fg[0], 0.0001);
574
+ }
575
+
576
+ test "colorMatrix - large buffer with SIMD and scalar mix" {
577
+ const pool = gp.initGlobalPool(std.testing.allocator);
578
+ defer gp.deinitGlobalPool();
579
+
580
+ // 100 pixels = 25 SIMD batches of 4
581
+ var buf = try OptimizedBuffer.init(
582
+ std.testing.allocator,
583
+ 100,
584
+ 1,
585
+ .{ .pool = pool, .id = "test-buffer" },
586
+ );
587
+ defer buf.deinit();
588
+
589
+ const bg = ansi.rgbaFromFloats(0.0, 0.0, 0.0, 1.0);
590
+ const red = ansi.rgbaFromFloats(1.0, 0.0, 0.0, 1.0);
591
+
592
+ buf.clear(bg, null);
593
+
594
+ // Set all to red
595
+ @memset(buf.buffer.fg, red);
596
+
597
+ // Apply sepia at full strength
598
+ buffer_effects.colorMatrixUniform(buf, &SEPIA_MATRIX, 1.0, ColorTarget.FG);
599
+
600
+ // All pixels should be transformed
601
+ const expected_r = 0.393;
602
+ const expected_g = 0.349;
603
+ const expected_b = 0.272;
604
+
605
+ for (0..100) |i| {
606
+ try expectRGBAApprox(ansi.rgbaFromFloats(expected_r, expected_g, expected_b, 1.0), buf.buffer.fg[i], 0.001);
607
+ }
608
+ }
609
+
610
+ test "colorMatrix - negative coordinates are skipped" {
611
+ const pool = gp.initGlobalPool(std.testing.allocator);
612
+ defer gp.deinitGlobalPool();
613
+
614
+ var buf = try OptimizedBuffer.init(
615
+ std.testing.allocator,
616
+ 3,
617
+ 3,
618
+ .{ .pool = pool, .id = "test-buffer" },
619
+ );
620
+ defer buf.deinit();
621
+
622
+ const bg = ansi.rgbaFromFloats(0.0, 0.0, 0.0, 1.0);
623
+ const red = ansi.rgbaFromFloats(1.0, 0.0, 0.0, 1.0);
624
+
625
+ buf.clear(bg, null);
626
+ buf.buffer.fg[4] = red; // (1, 1)
627
+
628
+ // Apply with negative coordinates followed by valid
629
+ const cell_mask = [_]f32{ -1.0, -1.0, 1.0, 1.0, 1.0, 1.0 };
630
+ buffer_effects.colorMatrix(buf, &SEPIA_MATRIX, &cell_mask, 1.0, ColorTarget.FG);
631
+
632
+ // Valid cell should be transformed
633
+ const expected_r = 0.393;
634
+ const expected_g = 0.349;
635
+ const expected_b = 0.272;
636
+ try expectRGBAApprox(ansi.rgbaFromFloats(expected_r, expected_g, expected_b, 1.0), buf.buffer.fg[4], 0.001);
637
+ }
638
+
639
+ test "colorMatrix - finite coordinates larger than u32 max are skipped" {
640
+ const pool = gp.initGlobalPool(std.testing.allocator);
641
+ defer gp.deinitGlobalPool();
642
+
643
+ var buf = try OptimizedBuffer.init(
644
+ std.testing.allocator,
645
+ 3,
646
+ 3,
647
+ .{ .pool = pool, .id = "test-buffer" },
648
+ );
649
+ defer buf.deinit();
650
+
651
+ const bg = ansi.rgbaFromFloats(0.0, 0.0, 0.0, 1.0);
652
+ const red = ansi.rgbaFromFloats(1.0, 0.0, 0.0, 1.0);
653
+
654
+ buf.clear(bg, null);
655
+ buf.buffer.fg[4] = red; // (1, 1)
656
+
657
+ // First triplet uses finite but out-of-range coordinates for u32 conversion.
658
+ // Second triplet is valid and should still be processed.
659
+ const huge = std.math.floatMax(f32);
660
+ const cell_mask = [_]f32{ huge, huge, 1.0, 1.0, 1.0, 1.0 };
661
+ buffer_effects.colorMatrix(buf, &SEPIA_MATRIX, &cell_mask, 1.0, ColorTarget.FG);
662
+
663
+ const expected_r = 0.393;
664
+ const expected_g = 0.349;
665
+ const expected_b = 0.272;
666
+ try expectRGBAApprox(ansi.rgbaFromFloats(expected_r, expected_g, expected_b, 1.0), buf.buffer.fg[4], 0.001);
667
+ }
668
+
669
+ // ==================== colorMatrixUniform Tests ====================
670
+
671
+ test "colorMatrixUniform - identity matrix leaves colors unchanged" {
672
+ const pool = gp.initGlobalPool(std.testing.allocator);
673
+ defer gp.deinitGlobalPool();
674
+
675
+ var buf = try OptimizedBuffer.init(
676
+ std.testing.allocator,
677
+ 4,
678
+ 1,
679
+ .{ .pool = pool, .id = "test-buffer" },
680
+ );
681
+ defer buf.deinit();
682
+
683
+ const bg = ansi.rgbaFromFloats(0.0, 0.0, 0.0, 1.0);
684
+ const red = ansi.rgbaFromFloats(1.0, 0.0, 0.0, 1.0);
685
+ const green = ansi.rgbaFromFloats(0.0, 1.0, 0.0, 1.0);
686
+ const blue = ansi.rgbaFromFloats(0.0, 0.0, 1.0, 1.0);
687
+ const white = ansi.rgbaFromFloats(1.0, 1.0, 1.0, 1.0);
688
+
689
+ buf.clear(bg, null);
690
+
691
+ // Set specific colors at different positions
692
+ buf.buffer.fg[0] = red;
693
+ buf.buffer.fg[1] = green;
694
+ buf.buffer.fg[2] = blue;
695
+ buf.buffer.fg[3] = white;
696
+
697
+ // Apply identity matrix at full strength to foreground
698
+ buffer_effects.colorMatrixUniform(buf, &IDENTITY_MATRIX, 1.0, ColorTarget.FG);
699
+
700
+ // Colors should be unchanged
701
+ try expectRGBAApprox(red, buf.buffer.fg[0], 0.0001);
702
+ try expectRGBAApprox(green, buf.buffer.fg[1], 0.0001);
703
+ try expectRGBAApprox(blue, buf.buffer.fg[2], 0.0001);
704
+ try expectRGBAApprox(white, buf.buffer.fg[3], 0.0001);
705
+ }
706
+
707
+ test "colorMatrixUniform - zero strength has no effect" {
708
+ const pool = gp.initGlobalPool(std.testing.allocator);
709
+ defer gp.deinitGlobalPool();
710
+
711
+ var buf = try OptimizedBuffer.init(
712
+ std.testing.allocator,
713
+ 2,
714
+ 2,
715
+ .{ .pool = pool, .id = "test-buffer" },
716
+ );
717
+ defer buf.deinit();
718
+
719
+ const bg = ansi.rgbaFromFloats(0.0, 0.0, 0.0, 1.0);
720
+ const red = ansi.rgbaFromFloats(1.0, 0.0, 0.0, 1.0);
721
+
722
+ buf.clear(bg, null);
723
+
724
+ @memset(buf.buffer.fg, red);
725
+
726
+ // Apply sepia matrix with zero strength
727
+ buffer_effects.colorMatrixUniform(buf, &SEPIA_MATRIX, 0.0, ColorTarget.FG);
728
+
729
+ // Colors should be unchanged
730
+ try expectRGBAApprox(red, buf.buffer.fg[0], 0.0001);
731
+ try expectRGBAApprox(red, buf.buffer.fg[3], 0.0001);
732
+ }
733
+
734
+ test "colorMatrixUniform - non-finite strength has no effect" {
735
+ const pool = gp.initGlobalPool(std.testing.allocator);
736
+ defer gp.deinitGlobalPool();
737
+
738
+ var buf = try OptimizedBuffer.init(
739
+ std.testing.allocator,
740
+ 2,
741
+ 1,
742
+ .{ .pool = pool, .id = "test-buffer" },
743
+ );
744
+ defer buf.deinit();
745
+
746
+ const bg = ansi.rgbaFromFloats(0.0, 0.0, 0.0, 1.0);
747
+ const red = ansi.rgbaFromFloats(1.0, 0.0, 0.0, 1.0);
748
+
749
+ buf.clear(bg, null);
750
+ buf.buffer.fg[0] = red;
751
+ buf.buffer.fg[1] = red;
752
+
753
+ const nan = std.math.nan(f32);
754
+ buffer_effects.colorMatrixUniform(buf, &SEPIA_MATRIX, nan, ColorTarget.FG);
755
+
756
+ try expectRGBAApprox(red, buf.buffer.fg[0], 0.0001);
757
+ try expectRGBAApprox(red, buf.buffer.fg[1], 0.0001);
758
+ }
759
+
760
+ test "colorMatrixUniform - grayscale transformation" {
761
+ const pool = gp.initGlobalPool(std.testing.allocator);
762
+ defer gp.deinitGlobalPool();
763
+
764
+ var buf = try OptimizedBuffer.init(
765
+ std.testing.allocator,
766
+ 3,
767
+ 1,
768
+ .{ .pool = pool, .id = "test-buffer" },
769
+ );
770
+ defer buf.deinit();
771
+
772
+ const bg = ansi.rgbaFromFloats(0.0, 0.0, 0.0, 1.0);
773
+ const red = ansi.rgbaFromFloats(1.0, 0.0, 0.0, 1.0);
774
+ const green = ansi.rgbaFromFloats(0.0, 1.0, 0.0, 1.0);
775
+ const blue = ansi.rgbaFromFloats(0.0, 0.0, 1.0, 1.0);
776
+
777
+ buf.clear(bg, null);
778
+
779
+ buf.buffer.fg[0] = red;
780
+ buf.buffer.fg[1] = green;
781
+ buf.buffer.fg[2] = blue;
782
+
783
+ // Apply grayscale matrix at full strength to foreground
784
+ buffer_effects.colorMatrixUniform(buf, &GRAYSCALE_MATRIX, 1.0, ColorTarget.FG);
785
+
786
+ // Calculate expected grayscale values
787
+ // Luminance = 0.299*R + 0.587*G + 0.114*B
788
+ const gray_red = 0.299 * 1.0 + 0.587 * 0.0 + 0.114 * 0.0; // ~0.299
789
+ const gray_green = 0.299 * 0.0 + 0.587 * 1.0 + 0.114 * 0.0; // ~0.587
790
+ const gray_blue = 0.299 * 0.0 + 0.587 * 0.0 + 0.114 * 1.0; // ~0.114
791
+
792
+ // All channels should equal the luminance value
793
+ try expectRGBAApprox(ansi.rgbaFromFloats(gray_red, gray_red, gray_red, 1.0), buf.buffer.fg[0], 0.001);
794
+ try expectRGBAApprox(ansi.rgbaFromFloats(gray_green, gray_green, gray_green, 1.0), buf.buffer.fg[1], 0.001);
795
+ try expectRGBAApprox(ansi.rgbaFromFloats(gray_blue, gray_blue, gray_blue, 1.0), buf.buffer.fg[2], 0.001);
796
+ }
797
+
798
+ test "colorMatrixUniform - partial strength blends with original" {
799
+ const pool = gp.initGlobalPool(std.testing.allocator);
800
+ defer gp.deinitGlobalPool();
801
+
802
+ var buf = try OptimizedBuffer.init(
803
+ std.testing.allocator,
804
+ 2,
805
+ 1,
806
+ .{ .pool = pool, .id = "test-buffer" },
807
+ );
808
+ defer buf.deinit();
809
+
810
+ const bg = ansi.rgbaFromFloats(0.0, 0.0, 0.0, 1.0);
811
+ const red = ansi.rgbaFromFloats(1.0, 0.0, 0.0, 1.0);
812
+
813
+ buf.clear(bg, null);
814
+ buf.buffer.fg[0] = red;
815
+ buf.buffer.fg[1] = red;
816
+
817
+ // Apply sepia at 50% strength
818
+ buffer_effects.colorMatrixUniform(buf, &SEPIA_MATRIX, 0.5, ColorTarget.FG);
819
+
820
+ // Expected: blend(original, sepia_result, 0.5)
821
+ // Sepia of pure red: R=0.393, G=0.349, B=0.272
822
+ // Blend: original + (sepia - original) * 0.5
823
+ const expected_r = 1.0 + (0.393 - 1.0) * 0.5;
824
+ const expected_g = 0.0 + (0.349 - 0.0) * 0.5;
825
+ const expected_b = 0.0 + (0.272 - 0.0) * 0.5;
826
+
827
+ try expectRGBAApprox(ansi.rgbaFromFloats(expected_r, expected_g, expected_b, 1.0), buf.buffer.fg[0], 0.001);
828
+ try expectRGBAApprox(ansi.rgbaFromFloats(expected_r, expected_g, expected_b, 1.0), buf.buffer.fg[1], 0.001);
829
+ }
830
+
831
+ test "colorMatrixUniform - target affects correct buffers" {
832
+ const pool = gp.initGlobalPool(std.testing.allocator);
833
+ defer gp.deinitGlobalPool();
834
+
835
+ var buf = try OptimizedBuffer.init(
836
+ std.testing.allocator,
837
+ 2,
838
+ 1,
839
+ .{ .pool = pool, .id = "test-buffer" },
840
+ );
841
+ defer buf.deinit();
842
+
843
+ const bg = ansi.rgbaFromFloats(0.0, 0.0, 0.0, 1.0);
844
+ const red = ansi.rgbaFromFloats(1.0, 0.0, 0.0, 1.0);
845
+ const blue = ansi.rgbaFromFloats(0.0, 0.0, 1.0, 1.0);
846
+
847
+ buf.clear(bg, null);
848
+
849
+ buf.buffer.fg[0] = red;
850
+ buf.buffer.bg[0] = blue;
851
+ buf.buffer.fg[1] = red;
852
+ buf.buffer.bg[1] = blue;
853
+
854
+ // Apply to FG only (target = 1)
855
+ buffer_effects.colorMatrixUniform(buf, &GRAYSCALE_MATRIX, 1.0, ColorTarget.FG);
856
+
857
+ // FG should be grayscale, BG should remain blue
858
+ const gray_red = 0.299 * 1.0;
859
+ try expectRGBAApprox(ansi.rgbaFromFloats(gray_red, gray_red, gray_red, 1.0), buf.buffer.fg[0], 0.001);
860
+ try expectRGBAApprox(blue, buf.buffer.bg[0], 0.0001);
861
+
862
+ // Reset and test BG only (target = 2)
863
+ buf.buffer.fg[0] = red;
864
+ buf.buffer.bg[0] = blue;
865
+ buf.buffer.fg[1] = red;
866
+ buf.buffer.bg[1] = blue;
867
+
868
+ buffer_effects.colorMatrixUniform(buf, &GRAYSCALE_MATRIX, 1.0, ColorTarget.BG);
869
+
870
+ // BG should be grayscale, FG should remain red
871
+ const gray_blue = 0.114 * 1.0;
872
+ try expectRGBAApprox(red, buf.buffer.fg[0], 0.0001);
873
+ try expectRGBAApprox(ansi.rgbaFromFloats(gray_blue, gray_blue, gray_blue, 1.0), buf.buffer.bg[0], 0.001);
874
+
875
+ // Reset and test Both (target = 3)
876
+ buf.buffer.fg[0] = red;
877
+ buf.buffer.bg[0] = blue;
878
+ buf.buffer.fg[1] = red;
879
+ buf.buffer.bg[1] = blue;
880
+
881
+ buffer_effects.colorMatrixUniform(buf, &GRAYSCALE_MATRIX, 1.0, ColorTarget.Both);
882
+
883
+ // Both should be grayscale
884
+ try expectRGBAApprox(ansi.rgbaFromFloats(gray_red, gray_red, gray_red, 1.0), buf.buffer.fg[0], 0.001);
885
+ try expectRGBAApprox(ansi.rgbaFromFloats(gray_blue, gray_blue, gray_blue, 1.0), buf.buffer.bg[0], 0.001);
886
+ }
887
+
888
+ test "colorMatrixUniform - handles buffer sizes not divisible by 4" {
889
+ const pool = gp.initGlobalPool(std.testing.allocator);
890
+ defer gp.deinitGlobalPool();
891
+
892
+ // Test with 5 pixels (1 SIMD batch of 4 + 1 scalar remainder)
893
+ var buf = try OptimizedBuffer.init(
894
+ std.testing.allocator,
895
+ 5,
896
+ 1,
897
+ .{ .pool = pool, .id = "test-buffer" },
898
+ );
899
+ defer buf.deinit();
900
+
901
+ const bg = ansi.rgbaFromFloats(0.0, 0.0, 0.0, 1.0);
902
+ const red = ansi.rgbaFromFloats(1.0, 0.0, 0.0, 1.0);
903
+
904
+ buf.clear(bg, null);
905
+
906
+ // Set all FG to red
907
+ for (0..5) |i| {
908
+ buf.buffer.fg[i] = red;
909
+ }
910
+
911
+ // Apply sepia at full strength
912
+ buffer_effects.colorMatrixUniform(buf, &SEPIA_MATRIX, 1.0, ColorTarget.FG);
913
+
914
+ // All pixels should be transformed (including the scalar fallback)
915
+ const expected_r = 0.393;
916
+ const expected_g = 0.349;
917
+ const expected_b = 0.272;
918
+
919
+ for (0..5) |i| {
920
+ try expectRGBAApprox(ansi.rgbaFromFloats(expected_r, expected_g, expected_b, 1.0), buf.buffer.fg[i], 0.001);
921
+ }
922
+ }
923
+
924
+ test "colorMatrixUniform - empty matrix returns early" {
925
+ const pool = gp.initGlobalPool(std.testing.allocator);
926
+ defer gp.deinitGlobalPool();
927
+
928
+ var buf = try OptimizedBuffer.init(
929
+ std.testing.allocator,
930
+ 2,
931
+ 1,
932
+ .{ .pool = pool, .id = "test-buffer" },
933
+ );
934
+ defer buf.deinit();
935
+
936
+ const bg = ansi.rgbaFromFloats(0.0, 0.0, 0.0, 1.0);
937
+ const red = ansi.rgbaFromFloats(1.0, 0.0, 0.0, 1.0);
938
+
939
+ buf.clear(bg, null);
940
+ buf.buffer.fg[0] = red;
941
+
942
+ // Empty matrix - should return early without changes
943
+ const empty_matrix: [0]f32 = .{};
944
+ buffer_effects.colorMatrixUniform(buf, &empty_matrix, 1.0, ColorTarget.FG);
945
+
946
+ // Color should be unchanged
947
+ try expectRGBAApprox(red, buf.buffer.fg[0], 0.0001);
948
+ }
949
+
950
+ test "colorMatrixUniform - alpha channel transformation" {
951
+ const pool = gp.initGlobalPool(std.testing.allocator);
952
+ defer gp.deinitGlobalPool();
953
+
954
+ var buf = try OptimizedBuffer.init(
955
+ std.testing.allocator,
956
+ 2,
957
+ 1,
958
+ .{ .pool = pool, .id = "test-buffer" },
959
+ );
960
+ defer buf.deinit();
961
+
962
+ const bg = ansi.rgbaFromFloats(0.0, 0.0, 0.0, 1.0);
963
+ const opaque_color = ansi.rgbaFromFloats(1.0, 0.0, 0.0, 1.0);
964
+ const transparent_color = ansi.rgbaFromFloats(0.0, 1.0, 0.0, 0.5);
965
+
966
+ buf.clear(bg, null);
967
+
968
+ buf.buffer.fg[0] = opaque_color;
969
+ buf.buffer.fg[1] = transparent_color;
970
+
971
+ // Apply matrix that halves alpha at full strength
972
+ buffer_effects.colorMatrixUniform(buf, &ALPHA_MODIFY_MATRIX, 1.0, ColorTarget.FG);
973
+
974
+ // Opaque should become semi-transparent (alpha = 1.0 * 0.5 = 0.5)
975
+ try expectRGBAApprox(ansi.rgbaFromFloats(1.0, 0.0, 0.0, 0.5), buf.buffer.fg[0], 0.0001);
976
+ // Semi-transparent should become more transparent (alpha = 0.5 * 0.5 = 0.25)
977
+ try expectRGBAApprox(ansi.rgbaFromFloats(0.0, 1.0, 0.0, 0.25), buf.buffer.fg[1], 0.0001);
978
+ }
979
+
980
+ test "colorMatrixUniform - very small buffer (less than 4 pixels)" {
981
+ const pool = gp.initGlobalPool(std.testing.allocator);
982
+ defer gp.deinitGlobalPool();
983
+
984
+ // Test with 2 pixels (all scalar, no SIMD)
985
+ var buf = try OptimizedBuffer.init(
986
+ std.testing.allocator,
987
+ 2,
988
+ 1,
989
+ .{ .pool = pool, .id = "test-buffer" },
990
+ );
991
+ defer buf.deinit();
992
+
993
+ const bg = ansi.rgbaFromFloats(0.0, 0.0, 0.0, 1.0);
994
+ const red = ansi.rgbaFromFloats(1.0, 0.0, 0.0, 1.0);
995
+ const green = ansi.rgbaFromFloats(0.0, 1.0, 0.0, 1.0);
996
+
997
+ buf.clear(bg, null);
998
+ buf.buffer.fg[0] = red;
999
+ buf.buffer.fg[1] = green;
1000
+
1001
+ // Apply sepia at full strength
1002
+ buffer_effects.colorMatrixUniform(buf, &SEPIA_MATRIX, 1.0, ColorTarget.FG);
1003
+
1004
+ // Both pixels should be transformed correctly using scalar path
1005
+ const expected_red_r = 0.393;
1006
+ const expected_red_g = 0.349;
1007
+ const expected_red_b = 0.272;
1008
+ try expectRGBAApprox(ansi.rgbaFromFloats(expected_red_r, expected_red_g, expected_red_b, 1.0), buf.buffer.fg[0], 0.001);
1009
+
1010
+ // Green transformed: R=0.769, G=0.686, B=0.534
1011
+ const expected_green_r = 0.769;
1012
+ const expected_green_g = 0.686;
1013
+ const expected_green_b = 0.534;
1014
+ try expectRGBAApprox(ansi.rgbaFromFloats(expected_green_r, expected_green_g, expected_green_b, 1.0), buf.buffer.fg[1], 0.001);
1015
+ }
1016
+
1017
+ test "colorMatrixUniform - single pixel buffer" {
1018
+ const pool = gp.initGlobalPool(std.testing.allocator);
1019
+ defer gp.deinitGlobalPool();
1020
+
1021
+ // Test with 1 pixel (edge case)
1022
+ var buf = try OptimizedBuffer.init(
1023
+ std.testing.allocator,
1024
+ 1,
1025
+ 1,
1026
+ .{ .pool = pool, .id = "test-buffer" },
1027
+ );
1028
+ defer buf.deinit();
1029
+
1030
+ const bg = ansi.rgbaFromFloats(0.0, 0.0, 0.0, 1.0);
1031
+ const red = ansi.rgbaFromFloats(1.0, 0.0, 0.0, 1.0);
1032
+
1033
+ buf.clear(bg, null);
1034
+ buf.buffer.fg[0] = red;
1035
+
1036
+ // Apply sepia at full strength
1037
+ buffer_effects.colorMatrixUniform(buf, &SEPIA_MATRIX, 1.0, ColorTarget.FG);
1038
+
1039
+ // Pixel should be transformed correctly
1040
+ const expected_r = 0.393;
1041
+ const expected_g = 0.349;
1042
+ const expected_b = 0.272;
1043
+ try expectRGBAApprox(ansi.rgbaFromFloats(expected_r, expected_g, expected_b, 1.0), buf.buffer.fg[0], 0.001);
1044
+ }
1045
+
1046
+ test "colorMatrixUniform - values can exceed 1.0 (no clamping)" {
1047
+ const pool = gp.initGlobalPool(std.testing.allocator);
1048
+ defer gp.deinitGlobalPool();
1049
+
1050
+ var buf = try OptimizedBuffer.init(
1051
+ std.testing.allocator,
1052
+ 2,
1053
+ 1,
1054
+ .{ .pool = pool, .id = "test-buffer" },
1055
+ );
1056
+ defer buf.deinit();
1057
+
1058
+ // Matrix that amplifies colors beyond 1.0
1059
+ const amplify_matrix = [16]f32{
1060
+ 2.0, 0.0, 0.0, 0.0, // Red output (2x)
1061
+ 0.0, 2.0, 0.0, 0.0, // Green output (2x)
1062
+ 0.0, 0.0, 2.0, 0.0, // Blue output (2x)
1063
+ 0.0, 0.0, 0.0, 1.0, // Alpha output
1064
+ };
1065
+
1066
+ const bg = ansi.rgbaFromFloats(0.0, 0.0, 0.0, 1.0);
1067
+ const gray = ansi.rgbaFromFloats(0.5, 0.5, 0.5, 1.0);
1068
+
1069
+ buf.clear(bg, null);
1070
+ buf.buffer.fg[0] = gray;
1071
+
1072
+ // Apply amplification at full strength
1073
+ buffer_effects.colorMatrixUniform(buf, &amplify_matrix, 1.0, ColorTarget.FG);
1074
+
1075
+ // Values should exceed 1.0 (no clamping)
1076
+ try expectRGBAApprox(ansi.rgbaFromFloats(1.0, 1.0, 1.0, 1.0), buf.buffer.fg[0], 0.0001);
1077
+ }
1078
+
1079
+ test "colorMatrixUniform - 3 pixel buffer (simd_end = 0, all scalar)" {
1080
+ const pool = gp.initGlobalPool(std.testing.allocator);
1081
+ defer gp.deinitGlobalPool();
1082
+
1083
+ // 3 pixels - simd_end will be 0, so all processed via scalar
1084
+ var buf = try OptimizedBuffer.init(
1085
+ std.testing.allocator,
1086
+ 3,
1087
+ 1,
1088
+ .{ .pool = pool, .id = "test-buffer" },
1089
+ );
1090
+ defer buf.deinit();
1091
+
1092
+ const bg = ansi.rgbaFromFloats(0.0, 0.0, 0.0, 1.0);
1093
+ const red = ansi.rgbaFromFloats(1.0, 0.0, 0.0, 1.0);
1094
+
1095
+ buf.clear(bg, null);
1096
+ for (0..3) |i| {
1097
+ buf.buffer.fg[i] = red;
1098
+ }
1099
+
1100
+ // Apply sepia
1101
+ buffer_effects.colorMatrixUniform(buf, &SEPIA_MATRIX, 1.0, ColorTarget.FG);
1102
+
1103
+ // All 3 should be transformed via scalar path
1104
+ const expected_r = 0.393;
1105
+ const expected_g = 0.349;
1106
+ const expected_b = 0.272;
1107
+
1108
+ for (0..3) |i| {
1109
+ try expectRGBAApprox(ansi.rgbaFromFloats(expected_r, expected_g, expected_b, 1.0), buf.buffer.fg[i], 0.001);
1110
+ }
1111
+ }