From 773104d3434441f0e038260f5ff844b10c845458 Mon Sep 17 00:00:00 2001
From: Mitchell Hashimoto <mitchell.hashimoto@gmail.com>
Date: Mon, 9 Oct 2023 09:40:28 -0700
Subject: [PATCH] terminal: scroll down tests

---
 src/terminal/Terminal.zig  | 76 +++++++++++++++++++++++++++++++++++++-
 website/app/vt/sd/page.mdx | 15 ++++++++
 2 files changed, 90 insertions(+), 1 deletion(-)
 create mode 100644 website/app/vt/sd/page.mdx

diff --git a/src/terminal/Terminal.zig b/src/terminal/Terminal.zig
index e47574b19..2930ad367 100644
--- a/src/terminal/Terminal.zig
+++ b/src/terminal/Terminal.zig
@@ -1702,7 +1702,6 @@ pub fn deleteLines(self: *Terminal, count: usize) !void {
 }
 
 /// Scroll the text down by one row.
-/// TODO: test
 pub fn scrollDown(self: *Terminal, count: usize) !void {
     const tracy = trace(@src());
     defer tracy.end();
@@ -5367,3 +5366,78 @@ test "Terminal: cursorRight right of right margin" {
         try testing.expectEqualStrings("    X", str);
     }
 }
+
+test "Terminal: scrollDown simple" {
+    const alloc = testing.allocator;
+    var t = try init(alloc, 5, 5);
+    defer t.deinit(alloc);
+
+    try t.printString("ABC");
+    t.carriageReturn();
+    try t.linefeed();
+    try t.printString("DEF");
+    t.carriageReturn();
+    try t.linefeed();
+    try t.printString("GHI");
+    t.setCursorPos(2, 2);
+    const cursor = t.screen.cursor;
+    try t.scrollDown(1);
+    try testing.expectEqual(cursor, t.screen.cursor);
+
+    {
+        var str = try t.plainString(testing.allocator);
+        defer testing.allocator.free(str);
+        try testing.expectEqualStrings("\nABC\nDEF\nGHI", str);
+    }
+}
+
+test "Terminal: scrollDown outside of scroll region" {
+    const alloc = testing.allocator;
+    var t = try init(alloc, 5, 5);
+    defer t.deinit(alloc);
+
+    try t.printString("ABC");
+    t.carriageReturn();
+    try t.linefeed();
+    try t.printString("DEF");
+    t.carriageReturn();
+    try t.linefeed();
+    try t.printString("GHI");
+    t.setScrollingRegion(3, 4);
+    t.setCursorPos(2, 2);
+    const cursor = t.screen.cursor;
+    try t.scrollDown(1);
+    try testing.expectEqual(cursor, t.screen.cursor);
+
+    {
+        var str = try t.plainString(testing.allocator);
+        defer testing.allocator.free(str);
+        try testing.expectEqualStrings("ABC\nDEF\n\nGHI", str);
+    }
+}
+
+test "Terminal: scrollDown left/right scroll region" {
+    const alloc = testing.allocator;
+    var t = try init(alloc, 10, 10);
+    defer t.deinit(alloc);
+
+    try t.printString("ABC123");
+    t.carriageReturn();
+    try t.linefeed();
+    try t.printString("DEF456");
+    t.carriageReturn();
+    try t.linefeed();
+    try t.printString("GHI789");
+    t.scrolling_region.left = 1;
+    t.scrolling_region.right = 3;
+    t.setCursorPos(2, 2);
+    const cursor = t.screen.cursor;
+    try t.scrollDown(1);
+    try testing.expectEqual(cursor, t.screen.cursor);
+
+    {
+        var str = try t.plainString(testing.allocator);
+        defer testing.allocator.free(str);
+        try testing.expectEqualStrings("A   23\nDBC156\nGEF489\n HI7", str);
+    }
+}
diff --git a/website/app/vt/sd/page.mdx b/website/app/vt/sd/page.mdx
new file mode 100644
index 000000000..bdd685295
--- /dev/null
+++ b/website/app/vt/sd/page.mdx
@@ -0,0 +1,15 @@
+import VTSequence from "@/components/VTSequence";
+
+# Scroll Down (SD)
+
+<VTSequence sequence={["CSI", "Pn", "T"]} />
+
+Inserts `n` lines at the top of the scroll region and shift existing
+lines down.
+
+This sequence is functionally identical to
+[Insert Line (IL)](/vt/il) with the cursor position set to the top of
+the scroll region. The cursor position after the operation must be unchanged
+from when SD was invoked.
+
+This sequence unsets the pending wrap state.