@@ -0,0 +1,126 @@
1+import { afterEach, describe, expect, test } from "bun:test";
2+import { cel } from "./cel.js";
3+import { MockTerminal } from "./terminal.js";
4+import { VStack, HStack } from "./primitives/stacks.js";
5+import { Text } from "./primitives/text.js";
6+
7+describe("layer compositing", () => {
8+ let term: MockTerminal;
9+
10+ afterEach(() => {
11+ cel.stop();
12+ });
13+
14+ function setup(columns = 20, rows = 5): MockTerminal {
15+ term = new MockTerminal(columns, rows);
16+ cel.init(term);
17+ return term;
18+ }
19+
20+ async function waitForRender(): Promise<void> {
21+ await new Promise((resolve) => setTimeout(resolve, 10));
22+ }
23+
24+ test("single layer renders normally", async () => {
25+ const term = setup(20, 3);
26+ cel.viewport(() => VStack({}, [Text("Hello")]));
27+ await waitForRender();
28+ expect(term.output).toContain("Hello");
29+ });
30+
31+ test("second layer paints over first", async () => {
32+ const term = setup(20, 3);
33+ cel.viewport(() => [
34+ VStack({}, [Text("AAAAAAAAAA")]),
35+ VStack({}, [Text("BB")]),
36+ ]);
37+ await waitForRender();
38+
39+ // "BB" should overwrite the first two A's, rest of A's visible
40+ const buf = cel._getBuffer()!;
41+ expect(buf.get(0, 0).char).toBe("B");
42+ expect(buf.get(1, 0).char).toBe("B");
43+ expect(buf.get(2, 0).char).toBe("A");
44+ });
45+
46+ test("transparent cells in upper layer show lower layer", async () => {
47+ const term = setup(10, 3);
48+ cel.viewport(() => [
49+ // Base layer: fill row 0 with A's
50+ VStack({}, [Text("AAAAAAAAAA")]),
51+ // Overlay layer: only paint at position (5,0)
52+ VStack({}, [
53+ HStack({}, [
54+ VStack({ width: 5 }, []),
55+ VStack({ width: 5 }, [Text("BB")]),
56+ ]),
57+ ]),
58+ ]);
59+ await waitForRender();
60+
61+ const buf = cel._getBuffer()!;
62+ // First 5 chars: A from base layer (overlay is empty/transparent)
63+ expect(buf.get(0, 0).char).toBe("A");
64+ expect(buf.get(4, 0).char).toBe("A");
65+ // Chars 5-6: B from overlay
66+ expect(buf.get(5, 0).char).toBe("B");
67+ expect(buf.get(6, 0).char).toBe("B");
68+ });
69+
70+ test("click targets topmost layer", async () => {
71+ const term = setup(20, 3);
72+ let baseClicked = false;
73+ let overlayClicked = false;
74+
75+ cel.viewport(() => [
76+ VStack(
77+ {
78+ onClick: () => {
79+ baseClicked = true;
80+ },
81+ },
82+ [Text("base")],
83+ ),
84+ VStack(
85+ {
86+ onClick: () => {
87+ overlayClicked = true;
88+ },
89+ },
90+ [Text("overlay")],
91+ ),
92+ ]);
93+ await waitForRender();
94+
95+ // Click at (3, 0) — should hit overlay, not base
96+ term.sendInput("\x1b[<0;4;1m");
97+ await waitForRender();
98+
99+ expect(overlayClicked).toBe(true);
100+ expect(baseClicked).toBe(false);
101+ });
102+
103+ test("conditional layer (modal show/hide)", async () => {
104+ const term = setup(20, 3);
105+ let showModal = false;
106+
107+ cel.viewport(() => {
108+ const layers = [VStack({}, [Text("main")])];
109+ if (showModal) {
110+ layers.push(VStack({}, [Text("modal")]));
111+ }
112+ return layers;
113+ });
114+ await waitForRender();
115+
116+ expect(term.output).toContain("main");
117+ expect(term.output).not.toContain("modal");
118+
119+ term.clearOutput();
120+ showModal = true;
121+ cel.render();
122+ await waitForRender();
123+
124+ expect(term.output).toContain("modal");
125+ });
126+});