@@ -186,66 +186,57 @@ describe("cel end-to-end", () => {
186186 expect(receivedKey).toBe("ctrl+s");
187187 });
188188
189- test("onScroll fires on mouse wheel", async () => {
190- const term = setup(20, 5);
189+ test("onScroll fires on mouse wheel using the adaptive default step", async () => {
190+ const term = setup(20, 12);
191191 let scrollOffset = 0;
192192 cel.viewport(() =>
193193 VStack(
194194 {
195195 width: 20,
196- height: 5,
196+ height: 12,
197197 overflow: "scroll",
198198 scrollOffset: scrollOffset,
199199 onScroll: (offset) => {
200200 scrollOffset = offset;
201201 },
202202 },
203- // Enough content to exceed viewport (5 rows)
204- Array.from({ length: 10 }, (_, i) => Text(`line ${i + 1}`)),
203+ // 12-row viewport → adaptive wheel step = floor(12 / 3) = 4
204+ Array.from({ length: 20 }, (_, i) => Text(`line ${i + 1}`)),
205205 ),
206206 );
207207 await waitForRender();
208208
209- // SGR scroll down at (3, 2): ESC [ < 65 ; 4 ; 3 M
210209 term.sendInput("\x1b[<65;4;3M");
211210 await waitForRender();
212211
213- expect(scrollOffset).toBe(1);
212+ expect(scrollOffset).toBe(4);
214213 });
215214
216215 test("batched mouse scroll events are all processed", async () => {
217- const term = setup(20, 5);
216+ const term = setup(20, 12);
218217 let scrollOffset = 0;
219218 cel.viewport(() =>
220219 VStack(
221220 {
222221 width: 20,
223- height: 5,
222+ height: 12,
224223 overflow: "scroll",
225224 scrollOffset: scrollOffset,
226225 onScroll: (offset) => {
227226 scrollOffset = offset;
228227 },
229228 },
230- [
231- Text("line1"),
232- Text("line2"),
233- Text("line3"),
234- Text("line4"),
235- Text("line5"),
236- Text("line6"),
237- Text("line7"),
238- Text("line8"),
239- ],
229+ Array.from({ length: 30 }, (_, i) => Text(`line${i + 1}`)),
240230 ),
241231 );
242232 await waitForRender();
243233
244234 // 3 scroll-down events batched in one data chunk (as real terminals do)
235+ // 12-row viewport → adaptive wheel step = 4, so total = 12
245236 term.sendInput("\x1b[<65;4;3M\x1b[<65;4;3M\x1b[<65;4;3M");
246237 await waitForRender();
247238
248- expect(scrollOffset).toBe(3);
239+ expect(scrollOffset).toBe(12);
249240 });
250241
251242 test("scroll clamps at max offset (no blank space past content)", async () => {
@@ -278,14 +269,14 @@ describe("cel end-to-end", () => {
278269 });
279270
280271 test("onScroll receives maxOffset", async () => {
281- const term = setup(20, 5);
272+ const term = setup(20, 12);
282273 let scrollOffset = 0;
283274 let receivedMax = -1;
284275 cel.viewport(() =>
285276 VStack(
286277 {
287278 width: 20,
288- height: 5,
279+ height: 12,
289280 overflow: "scroll",
290281 scrollOffset: scrollOffset,
291282 onScroll: (offset, maxOffset) => {
@@ -293,8 +284,8 @@ describe("cel end-to-end", () => {
293284 receivedMax = maxOffset;
294285 },
295286 },
296- // 8 items in 5-row viewport → max offset = 3
297- Array.from({ length: 8 }, (_, i) => Text(`item ${i + 1}`)),
287+ // 20 items in 12-row viewport → max offset = 8
288+ Array.from({ length: 20 }, (_, i) => Text(`item ${i + 1}`)),
298289 ),
299290 );
300291 await waitForRender();
@@ -302,20 +293,46 @@ describe("cel end-to-end", () => {
302293 term.sendInput("\x1b[<65;4;3M");
303294 await waitForRender();
304295
305- expect(scrollOffset).toBe(1);
306- expect(receivedMax).toBe(3);
296+ expect(scrollOffset).toBe(4);
297+ expect(receivedMax).toBe(8);
298+ });
299+
300+ test("scrollStep overrides the adaptive default", async () => {
301+ const term = setup(20, 12);
302+ let scrollOffset = 0;
303+ cel.viewport(() =>
304+ VStack(
305+ {
306+ width: 20,
307+ height: 12,
308+ overflow: "scroll",
309+ scrollStep: 6,
310+ scrollOffset: scrollOffset,
311+ onScroll: (offset) => {
312+ scrollOffset = offset;
313+ },
314+ },
315+ Array.from({ length: 30 }, (_, i) => Text(`line ${i + 1}`)),
316+ ),
317+ );
318+ await waitForRender();
319+
320+ term.sendInput("\x1b[<65;4;3M");
321+ await waitForRender();
322+
323+ expect(scrollOffset).toBe(6);
307324 });
308325
309326 test("uncontrolled scroll works without onScroll", async () => {
310- const term = setup(20, 5);
327+ const term = setup(20, 12);
311328 cel.viewport(() =>
312329 VStack(
313330 {
314331 width: 20,
315- height: 5,
332+ height: 12,
316333 overflow: "scroll",
317334 },
318- Array.from({ length: 10 }, (_, i) => Text(`line ${i + 1}`)),
335+ Array.from({ length: 20 }, (_, i) => Text(`line ${i + 1}`)),
319336 ),
320337 );
321338 await waitForRender();
@@ -324,16 +341,14 @@ describe("cel end-to-end", () => {
324341 const buf1 = cel._getBuffer()!;
325342 expect(buf1.get(0, 0).char).toBe("l"); // "line 1"
326343
327- // SGR scroll down at (3, 2): ESC [ < 65 ; 4 ; 3 M
328344 term.sendInput("\x1b[<65;4;3M");
329345 await waitForRender();
330346
331- // After scroll by 1, line 2 should now be at row 0
347+ // After scrolling by the adaptive step (4), line 5 should now be at row 0
332348 const buf2 = cel._getBuffer()!;
333- // Read first 6 chars of row 0
334349 let row0 = "";
335350 for (let x = 0; x < 6; x++) row0 += buf2.get(x, 0).char;
336- expect(row0).toBe("line 2");
351+ expect(row0).toBe("line 5");
337352 });
338353
339354 test("uncontrolled scroll clamps at max offset", async () => {
@@ -417,7 +432,7 @@ describe("cel end-to-end", () => {
417432 cel.render();
418433 },
419434 },
420- // 10 items in 5-row viewport → max offset = 5
435+ // 10 items in 5-row viewport → max offset = 5, adaptive wheel step = 3
421436 Array.from({ length: 10 }, (_, i) => Text(`line ${i + 1}`)),
422437 ),
423438 );
@@ -431,7 +446,7 @@ describe("cel end-to-end", () => {
431446 await waitForRender();
432447
433448 expect(stickToBottom).toBe(false);
434- expect(scrollOffset).toBe(4); // maxOffset(5) - 1 = 4
449+ expect(scrollOffset).toBe(2); // maxOffset(5) - 3 = 2
435450 });
436451 });
437452
@@ -1251,18 +1266,20 @@ describe("cel end-to-end", () => {
12511266
12521267 describe("TextInput mouse wheel scroll", () => {
12531268 test("mouse wheel scrolls TextInput content", async () => {
1254- const term = setup(20, 3);
1255- let value = "line1\nline2\nline3\nline4\nline5";
1269+ const term = setup(20, 12);
1270+ let value = Array.from({ length: 20 }, (_, i) => `line${i + 1}`).join(
1271+ "\n",
1272+ );
12561273 // Stable onChange ref so TextInput scroll state persists across re-renders
12571274 const onChange = (v: string) => {
12581275 value = v;
12591276 };
12601277
12611278 cel.viewport(() =>
1262- VStack({ width: 20, height: 3 }, [
1279+ VStack({ width: 20, height: 12 }, [
12631280 TextInput({
12641281 value,
1265- height: 3,
1282+ height: 12,
12661283 onChange,
12671284 }),
12681285 ]),
@@ -1275,15 +1292,14 @@ describe("cel end-to-end", () => {
12751292 for (let x = 0; x < 5; x++) row0 += buf1.get(x, 0).char;
12761293 expect(row0).toBe("line1");
12771294
1278- // Scroll down at (5, 1)
1295+ // 12-row viewport → adaptive wheel step = 4
12791296 term.sendInput("\x1b[<65;6;2M");
12801297 await waitForRender();
12811298
1282- // After scrolling down, line1 should no longer be at row 0
12831299 const buf2 = cel._getBuffer()!;
12841300 let row0After = "";
12851301 for (let x = 0; x < 5; x++) row0After += buf2.get(x, 0).char;
1286- expect(row0After).toBe("line2");
1302+ expect(row0After).toBe("line5");
12871303 });
12881304
12891305 test("mouse wheel scroll up clamps at 0", async () => {
@@ -1316,9 +1332,11 @@ describe("cel end-to-end", () => {
13161332 });
13171333
13181334 test("mouse wheel prefers innermost TextInput over outer scrollable", async () => {
1319- const term = setup(20, 3);
1335+ const term = setup(20, 12);
13201336 let outerScrolled = false;
1321- let value = "line1\nline2\nline3\nline4";
1337+ let value = Array.from({ length: 20 }, (_, i) => `line${i + 1}`).join(
1338+ "\n",
1339+ );
13221340 const onChange = (v: string) => {
13231341 value = v;
13241342 };
@@ -1327,7 +1345,7 @@ describe("cel end-to-end", () => {
13271345 VStack(
13281346 {
13291347 width: 20,
1330- height: 3,
1348+ height: 12,
13311349 overflow: "scroll",
13321350 scrollOffset: 0,
13331351 onScroll: () => {
@@ -1337,7 +1355,7 @@ describe("cel end-to-end", () => {
13371355 [
13381356 TextInput({
13391357 value,
1340- height: 3,
1358+ height: 12,
13411359 onChange,
13421360 }),
13431361 ],
@@ -1351,11 +1369,11 @@ describe("cel end-to-end", () => {
13511369
13521370 expect(outerScrolled).toBe(false);
13531371
1354- // Verify TextInput scrolled
1372+ // Verify TextInput scrolled by the adaptive step (4)
13551373 const buf = cel._getBuffer()!;
13561374 let row0 = "";
13571375 for (let x = 0; x < 5; x++) row0 += buf.get(x, 0).char;
1358- expect(row0).toBe("line2");
1376+ expect(row0).toBe("line5");
13591377 });
13601378 });
13611379