scroll/src/common/all_test.ts

import Buffer from './buffer.ts';
import Document from './document.ts';
import Editor from './editor.ts';
import Row from './row.ts';
import { Ansi, KeyCommand } from './ansi.ts';
import { defaultTerminalSize } from './config.ts';
import { getTestRunner } from './runtime.ts';
import { Position } from './types.ts';
import * as Util from './fns.ts';

const {
	assertEquals,
	assertExists,
	assertInstanceOf,
	assertNotEquals,
	assertFalse,
	assertTrue,
	testSuite,
} = await getTestRunner();

const encoder = new TextEncoder();
const testKeyMap = (codes: string[], expected: string) => {
	codes.forEach((code) => {
		assertEquals(Util.readKey(encoder.encode(code)), expected);
	});
};

testSuite({
	'ANSI utils': {
		'moveCursor()': () => {
			assertEquals(Ansi.moveCursor(1, 2), '\x1b[2;3H');
		},
		'moveCursorForward()': () => {
			assertEquals(Ansi.moveCursorForward(2), '\x1b[2C');
		},
		'moveCursorDown()': () => {
			assertEquals(Ansi.moveCursorDown(7), '\x1b[7B');
		},
	},
	Buffer: {
		'new Buffer': () => {
			const b = new Buffer();
			assertInstanceOf(b, Buffer);
			assertEquals(b.strlen(), 0);
		},
		'.appendLine': () => {
			const b = new Buffer();

			// Carriage return and line feed
			b.appendLine();
			assertEquals(b.strlen(), 2);

			b.clear();
			assertEquals(b.strlen(), 0);

			b.appendLine('foo');
			assertEquals(b.strlen(), 5);
		},
		'.append': () => {
			const b = new Buffer();

			b.append('foobar');
			assertEquals(b.strlen(), 6);
			b.clear();

			b.append('foobar', 3);
			assertEquals(b.strlen(), 3);
		},
		'.flush': async () => {
			const b = new Buffer();
			b.appendLine('foobarbaz' + Ansi.ClearLine);
			assertEquals(b.strlen(), 14);

			await b.flush();

			assertEquals(b.strlen(), 0);
		},
	},
	Document: {
		'.default': () => {
			const doc = Document.default();
			assertEquals(doc.numRows, 0);
			assertTrue(doc.isEmpty());
			assertEquals(doc.row(0), null);
		},
		'.insertRow': () => {
			const doc = Document.default();
			doc.insertRow(undefined, 'foobar');
			assertEquals(doc.numRows, 1);
			assertFalse(doc.isEmpty());
			assertInstanceOf(doc.row(0), Row);
		},
		'.insert': () => {
			const doc = Document.default();
			assertFalse(doc.dirty);
			doc.insert(Position.at(0, 0), 'foobar');
			assertEquals(doc.numRows, 1);
			assertTrue(doc.dirty);

			doc.insert(Position.at(2, 0), 'baz');
			assertEquals(doc.numRows, 1);
			assertTrue(doc.dirty);

			doc.insert(Position.at(9, 0), 'buzz');
			assertEquals(doc.numRows, 1);
			assertTrue(doc.dirty);
			const row0 = doc.row(0);
			assertEquals(row0?.toString(), 'foobazbarbuzz');
			assertEquals(row0?.rstring(), 'foobazbarbuzz');
			assertEquals(row0?.rsize, 13);

			doc.insert(Position.at(0, 1), 'Lorem Ipsum');
			assertEquals(doc.numRows, 2);
			assertTrue(doc.dirty);
		},
		'.delete': () => {
			const doc = Document.default();
			doc.insert(Position.default(), 'foobar');
			doc.delete(Position.at(3, 0));
			assertEquals(doc.row(0)?.toString(), 'fooar');
		},
	},
	Editor: {
		'new Editor': () => {
			const e = new Editor(defaultTerminalSize);
			assertInstanceOf(e, Editor);
		},
	},
	Position: {
		'.default': () => {
			const p = Position.default();
			assertEquals(p.x, 0);
			assertEquals(p.y, 0);
		},
		'.at': () => {
			const p = Position.at(5, 7);
			assertEquals(p.x, 5);
			assertEquals(p.y, 7);
		},
	},
	Row: {
		'.default': () => {
			const row = Row.default();
			assertEquals(row.toString(), '');
		},
		'.from': () => {
			// From string
			const row = Row.from('xyz');
			assertEquals(row.toString(), 'xyz');

			// From existing Row
			assertEquals(Row.from(row).toString(), row.toString());

			// From 'chars'
			assertEquals(Row.from(['😺', '😸', '😹']).toString(), '😺😸😹');
		},
	},
	'fns': {
		'arrayInsert() strings': () => {
			const a = ['😺', '😸', '😹'];
			const b = Util.arrayInsert(a, 1, 'x');
			const c = ['😺', 'x', '😸', '😹'];
			assertEquals(b, c);

			const d = Util.arrayInsert(c, 17, 'y');
			const e = ['😺', 'x', '😸', '😹', 'y'];
			assertEquals(d, e);

			assertEquals(Util.arrayInsert([], 0, 'foo'), ['foo']);
		},
		'arrayInsert() numbers': () => {
			const a = [1, 3, 5];
			const b = [1, 3, 4, 5];
			assertEquals(Util.arrayInsert(a, 2, 4), b);

			const c = [1, 2, 3, 4, 5];
			assertEquals(Util.arrayInsert(b, 1, 2), c);
		},
		'noop fn': () => {
			assertExists(Util.noop);
			assertEquals(Util.noop(), undefined);
		},
		'posSub()': () => {
			assertEquals(Util.posSub(14, 15), 0);
			assertEquals(Util.posSub(15, 1), 14);
		},
		'minSub()': () => {
			assertEquals(Util.minSub(13, 25, -1), -1);
			assertEquals(Util.minSub(25, 13, 0), 12);
		},
		'maxAdd()': () => {
			assertEquals(Util.maxAdd(99, 99, 75), 75);
			assertEquals(Util.maxAdd(25, 74, 101), 99);
		},
		'ord()': () => {
			// Invalid output
			assertEquals(Util.ord(''), 256);

			// Valid output
			assertEquals(Util.ord('a'), 97);
		},
		'chars() properly splits strings into unicode characters': () => {
			assertEquals(Util.chars('😺😸😹'), ['😺', '😸', '😹']);
		},
		'ctrlKey()': () => {
			const ctrl_a = Util.ctrlKey('a');
			assertTrue(Util.isControl(ctrl_a));
			assertEquals(ctrl_a, String.fromCodePoint(0x01));

			const invalid = Util.ctrlKey('😺');
			assertFalse(Util.isControl(invalid));
			assertEquals(invalid, '😺');
		},
		'isAscii()': () => {
			assertTrue(Util.isAscii('asjyverkjhsdf1928374'));
			assertFalse(Util.isAscii('😺acalskjsdf'));
			assertFalse(Util.isAscii('ab😺ac'));
		},
		'isControl()': () => {
			assertFalse(Util.isControl('abc'));
			assertTrue(Util.isControl(String.fromCodePoint(0x01)));
			assertFalse(Util.isControl('😺'));
		},
		'strlen()': () => {
			// Ascii length
			assertEquals(Util.strlen('abc'), 'abc'.length);

			// Get number of visible unicode characters
			assertEquals(Util.strlen('😺😸😹'), 3);
			assertNotEquals('😺😸😹'.length, Util.strlen('😺😸😹'));

			// Skin tone modifier + base character
			assertEquals(Util.strlen('🤰🏼'), 2);
			assertNotEquals('🤰🏼'.length, Util.strlen('🤰🏼'));

			// This has 4 sub-characters, and 3 zero-width-joiners
			assertEquals(Util.strlen('👨‍👩‍👧‍👦'), 7);
			assertNotEquals('👨‍👩‍👧‍👦'.length, Util.strlen('👨‍👩‍👧‍👦'));
		},
		'truncate()': () => {
			assertEquals(Util.truncate('😺😸😹', 1), '😺');
			assertEquals(Util.truncate('😺😸😹', 5), '😺😸😹');
			assertEquals(Util.truncate('👨‍👩‍👧‍👦', 5), '👨‍👩‍👧');
		},
	},
	'readKey()': {
		'empty input': () => {
			assertEquals(Util.readKey(new Uint8Array(0)), '');
		},
		'passthrough': () => {
			// Ignore unhandled escape sequences
			assertEquals(Util.readKey(encoder.encode('\x1b[]')), '\x1b[]');

			// Pass explicitly mapped values right through
			assertEquals(
				Util.readKey(encoder.encode(KeyCommand.ArrowUp)),
				KeyCommand.ArrowUp,
			);
			assertEquals(
				Util.readKey(encoder.encode(KeyCommand.Home)),
				KeyCommand.Home,
			);
			assertEquals(
				Util.readKey(encoder.encode(KeyCommand.Delete)),
				KeyCommand.Delete,
			);

			// And pass through whatever else
			assertEquals(Util.readKey(encoder.encode('foobaz')), 'foobaz');
		},

		'Esc': () => testKeyMap(['\x1b', Util.ctrlKey('l')], KeyCommand.Escape),
		'Backspace': () =>
			testKeyMap(
				[Util.ctrlKey('h'), '\x7f'],
				KeyCommand.Backspace,
			),
		'Home': () =>
			testKeyMap(['\x1b[1~', '\x1b[7~', '\x1b[H', '\x1bOH'], KeyCommand.Home),
		'End': () =>
			testKeyMap(['\x1b[4~', '\x1b[8~', '\x1b[F', '\x1bOF'], KeyCommand.End),
		'Enter': () => testKeyMap(['\n', '\r', '\v'], KeyCommand.Enter),
	},
});