tzo 1.0.18 → 1.0.20

package/dist/browser/vm.test.js

@@ -1,356 +1,399 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-const vm_1 = require("./vm");
-const tokenizer_1 = require("./util/tokenizer");
-const jest_mock_process_1 = require("jest-mock-process");
-const fs_1 = __importDefault(require("fs"));
-const EMIT_TEST_JSONS = true; // set to true to emit test jsons in `src/tests`
-if (EMIT_TEST_JSONS) {
-    // clean folder first!
-    const files = fs_1.default.readdirSync("./src/tests");
-    files.forEach(f => {
-        fs_1.default.unlinkSync(`./src/tests/${f}`);
-    });
-}
-function createVMAndRunStdRepCode(instructions, initialContext, initialLabelMap) {
-    if (initialLabelMap === undefined) {
-        initialLabelMap = {};
-    }
-    const vm = new vm_1.VM(initialContext !== undefined ? initialContext : {});
-    vm.loadProgramList(instructions, initialLabelMap);
-    vm.run();
-    return vm;
-}
-function createVM(codeBlock, initialContext, initialLabelMap) {
-    if (initialLabelMap === undefined) {
-        initialLabelMap = {};
-    }
-    const vm = new vm_1.VM(initialContext !== undefined ? initialContext : {});
-    const tokenizer = new tokenizer_1.Tokenizer();
-    const instructions = tokenizer.parse(codeBlock);
-    vm.loadProgramList(instructions, initialLabelMap);
-    return { vm, instructions };
-}
-function createVMAndRunCode(codeBlock, initialContext, initialLabelMap) {
-    const { vm } = createVM(codeBlock, initialContext, initialLabelMap);
-    vm.run();
-    return vm;
-}
-let lastTest = 0;
-function expectVM(codeBlock, initialContext, expectations, testname) {
-    const { instructions, vm } = createVM(codeBlock, initialContext);
-    let usedTestName = testname;
-    if (testname === undefined) {
-        usedTestName = "" + lastTest;
-        lastTest += 1;
-    }
-    if (EMIT_TEST_JSONS) {
-        fs_1.default.writeFileSync(`./src/tests/${usedTestName}.json`, JSON.stringify({
-            input_program: instructions,
-            initial_context: initialContext,
-            expected: {
-                stack: expectations.stack,
-                context: expectations.context,
-                programCounter: expectations.programCounter
-            }
-        }, null, 2));
-    }
-    vm.run();
-    if (expectations.stack !== undefined) {
-        expect(vm.stack).toEqual(expectations.stack);
-    }
-    if (expectations.context !== undefined) {
-        expect(vm.context).toEqual(expectations.context);
-    }
-    if (expectations.programCounter !== undefined) {
-        expect(vm.programCounter).toEqual(expectations.programCounter);
-    }
-}
-function expectStack(codeBlock, expectedStack, testname) {
-    expectVM(codeBlock, {}, {
-        stack: expectedStack
-    }, testname);
-}
-test('should have an initial state', () => {
-    const vm = new vm_1.VM({});
-    expect(vm.programCounter).toBe(0);
-    expect(vm.context).toEqual({});
-    expect(vm.labelMap).toEqual({});
-    expect(vm.programList).toEqual([]);
-    expect(vm.stack).toEqual([]);
-    expect(vm.exit).toBe(false);
-    expect(vm.pause).toBe(false);
-});
-test('should push numbers to the stack', () => {
-    expectStack(`1 2 3`, [1, 2, 3], "push_numbers");
-    expectStack(`-1 -2 -3`, [-1, -2, -3], "push_negative_numbers");
-});
-test('should push strings to the stack', () => {
-    expectStack(`"foo" "bar" "baz"`, ["foo", "bar", "baz"], "push_strings");
-});
-test('should set context', () => {
-    expectVM(`"FOO" "bar" setContext`, {}, { context: { bar: "FOO" } }, "setContext_string");
-    expectVM(`1 "bar" setContext`, {}, { context: { bar: 1 } }, "setContext_number");
-});
-test('should get context', () => {
-    const ctx = { "ham": "ster", "one": 1, "two": 2 };
-    expectVM(`"ham" getContext`, ctx, { stack: ["ster"] }, "getContext_1");
-    expectVM(`"one" getContext`, ctx, { stack: [1] }, "getContext_2");
-    expectVM(`"two" getContext`, ctx, { stack: [2] }, "getContext_3");
-});
-test('should be able to text if context variable exists', () => {
-    const ctx = { "ham": "ster", "one": 1, "two": 2 };
-    expectVM(`"ham" hasContext`, ctx, { stack: [1] }, "hasContext_1");
-    expectVM(`"one" hasContext`, ctx, { stack: [1] }, "hasContext_2");
-    expectVM(`"foobar" hasContext`, ctx, { stack: [0] }, "hasContext_3");
-});
-test('should delete context', () => {
-    expectVM(`"FOO" "bar" setContext "bar" delContext`, {}, { context: {} }, "delContext");
-});
-test('should throw an error when trying to get context for unknown variables', () => {
-    const ctx = { "ham": "ster", "one": 1, "two": 2 };
-    expect(() => createVMAndRunCode(`"asdfzxc" getContext`, ctx)).toThrow();
-});
-test('should add numbers', () => {
-    expectStack(`1 2 +`, [3], "plus_0");
-    expectStack(`1 2 plus`, [3], "plus_1");
-});
-test('should subtract numbers', () => {
-    expectStack(`1 2 -`, [1], "min_0");
-    expectStack(`1 2 min`, [1], "min_1");
-    expectStack(`1 10 min`, [9], "min_2");
-});
-test('should multiply numbers', () => {
-    expectStack(`2 3 *`, [6], "multiply_0");
-    expectStack(`2 3 mul`, [6], "multiply_1");
-});
-test('should support the not instruction', () => {
-    expectStack(`0 not`, [1], "not_0");
-    expectStack(`1 not`, [0], "not_1");
-    expectStack(`42 not`, [0], "not_2");
-});
-test('should support jgz, { and } for jgz-style if statements', () => {
-    expectStack(`1 jgz { "EXPECT_THIS" } "AND_THIS"`, ["EXPECT_THIS", "AND_THIS"], "if_jgz_0");
-    expectStack(`0 jgz { "EXPECT_NOT_THIS" } "EXPECT_ONLY_THIS"`, ["EXPECT_ONLY_THIS"], "if_jgz_1");
-});
-test('should support jz', () => {
-    expectStack(`0 jz "no"`, [], "jz_0");
-    expectStack(`1 jz "yes"`, ["yes"], "jz_1");
-    expectStack(`-1 jz "yes"`, ["yes"], "jz_2");
-});
-test('should support jgz', () => {
-    expectStack(`0 jgz "yes"`, ["yes"], "jgz_0");
-    expectStack(`-1 jgz "yes"`, ["yes"], "jgz_1");
-    expectStack(`1 jgz "no"`, [], "jgz_2");
-});
-test('should support braces', () => {
-    expectStack(`1 2 { 3 4 5 } 6 7`, [1, 2, 6, 7], "braces");
-});
-test('should support nested braces', () => {
-    expectStack(`1 2 { 3 { 4 5 } 6 } 7`, [1, 2, 7], "braces_nested");
-});
-test('should support the goto instruction', () => {
-    expectStack(`5 goto "foo" "bar" "baz" "quux" exit`, ["quux"], "goto_by_number");
-    expectStack(`"myLabel" goto "foo" "bar" "baz" "quux" #myLabel exit`, ["quux"], "goto_by_label");
-    expect(createVMAndRunCode(`"myLabel" goto "foo" "bar" "baz" "quux" exit`, {}, { myLabel: 5 }).stack).toEqual(["quux"]);
-});
-test('should calculate equality between values on the stack', () => {
-    expectStack(`1 1 eq`, [1], "eq_0"); // equal
-    expectStack(`0 0 eq`, [1], "eq_1"); // equal
-    expectStack(`"foo" "foo" eq`, [1], "eq_2"); // equal
-    expectStack(`"foo" "bar" eq`, [0], "eq_3"); // not equal
-    expectStack(`1 2 eq`, [0], "eq_4"); // not equal
-    expectStack(`2 1 eq`, [0], "eq_5"); // not equal
-    expectStack(`"0" 0 eq`, [0], "eq_6"); // not equal
-});
-test('should calculate greater than', () => {
-    expectStack(`1 1 gt`, [0], 'gt_0'); // not greater than
-    expectStack(`1 0 gt`, [0], 'gt_1'); // not greater than
-    expectStack(`1 2 gt`, [1], 'gt_2'); // greater than
-    expectStack(`1 -2 gt`, [0], 'gt_3'); // not greater than
-    expectStack(`-1 2 gt`, [1], 'gt_4'); // greater than
-    expectStack(`-1 -2 gt`, [0], 'gt_5'); // not greater than
-    expectStack(`-2 -1 gt`, [1], 'gt_6'); // greater than
-    expectStack(`-2 -2 gt`, [0], 'gt_7'); // not greater than
-});
-test('should calculate less than', () => {
-    expectStack(`1 1 lt`, [0], 'lt_0'); // not less than
-    expectStack(`1 2 lt`, [0], 'lt_1'); // not less than
-    expectStack(`1 0 lt`, [1], 'lt_2'); // less than
-    expectStack(`1 -1 lt`, [1], 'lt_3'); // less than
-    expectStack(`-1 -1 lt`, [0], 'lt_4'); // not less than
-    expectStack(`-1 -2 lt`, [1], 'lt_5'); // not less than
-    expectStack(`-1 2 lt`, [0], 'lt_6'); // not less than
-    expectStack(`2 -1 lt`, [1], 'lt_7'); // not less than
-});
-test('should concat', () => {
-    expectStack(`"one" "two" concat`, ["twoone"], "concat_0");
-    expectStack(`"1" "two" concat`, ["two1"], "concat_1");
-    expectStack(`1 2 concat`, ["21"], "concat_2");
-    expectStack(`"one" 2 concat`, ["2one"], "concat_3");
-});
-test('should rconcat (reverse concat)', () => {
-    expectStack(`"one" "two" rconcat`, ["onetwo"], "rconcat_0");
-    expectStack(`"1" "two" rconcat`, ["1two"], "rconcat_1");
-    expectStack(`1 2 rconcat`, ["12"], "rconcat_2");
-    expectStack(`"one" 2 rconcat`, ["one2"], "rconcat_3");
-});
-test('should pause', () => {
-    const vm = createVMAndRunCode(`"foo" "bar" pause "baz" "quux"`);
-    expect(vm.stack).toEqual(["foo", "bar"]);
-    expect(vm.pause).toEqual(true);
-    expect(vm.exit).toEqual(false);
-    expect(vm.programCounter).toEqual(3); // pause WILL increment the programCounter!
-    vm.run();
-    expect(vm.stack).toEqual(["foo", "bar", "baz", "quux"]);
-    expect(vm.pause).toEqual(false);
-    expect(vm.exit).toEqual(true);
-    expect(vm.programCounter).toEqual(5);
-});
-test('should exit', () => {
-    const vm = createVMAndRunCode(`"foo" "bar" exit "baz" "quux"`);
-    expect(vm.stack).toEqual(["foo", "bar"]);
-    expect(vm.pause).toEqual(false);
-    expect(vm.exit).toEqual(true);
-    expect(vm.programCounter).toEqual(3); // exit WILL increment the programCounter!
-    vm.run(); // this is a no-op, effectively, as the VM can not run anymore!
-    expect(vm.stack).toEqual(["foo", "bar"]);
-    expect(vm.pause).toEqual(false);
-    expect(vm.exit).toEqual(true);
-    expect(vm.programCounter).toEqual(3);
-});
-test('should push program counter on ppc instruction', () => {
-    expectStack(`nop nop ppc`, [2], "ppc_0");
-    expectStack(`ppc`, [0], "ppc_1");
-});
-test('should do nothing on nop instruction', () => {
-    expectStack(`nop nop nop`, [], "nop_0");
-    expectVM(`nop`, {}, { programCounter: 1, context: {}, stack: [] }, "nop_1");
-});
-test('should calculate and', () => {
-    expectStack(`1 1 and`, [1], "and_0");
-    expectStack(`1 0 and`, [0], "and_1");
-    expectStack(`0 1 and`, [0], "and_2");
-    expectStack(`0 0 and`, [0], "and_3");
-    expectStack(`1 9 and`, [1], "and_4");
-    expectStack(`9 1 and`, [1], "and_5");
-});
-test('should calculate or', () => {
-    expectStack(`1 1 or`, [1], "or_0");
-    expectStack(`1 0 or`, [1], "or_1");
-    expectStack(`0 1 or`, [1], "or_2");
-    expectStack(`0 0 or`, [0], "or_3");
-    expectStack(`1 9 or`, [1], "or_4");
-    expectStack(`9 1 or`, [1], "or_5");
-});
-test('should duplicate top item from stack via dup', () => {
-    expectStack(`1 dup`, [1, 1], "dup_0");
-    expectStack(`0 dup`, [0, 0], "dup_1");
-    expectStack(`"test" dup`, ["test", "test"], "dup_2");
-    expectStack(`42 dup`, [42, 42], "dup_3");
-});
-test('should pop top item from stack via pop', () => {
-    expectStack(`1 pop`, [], "pop_0");
-    expectStack(`0 pop`, [], "pop_1");
-    expectStack(`"test" pop`, [], "pop_2");
-    expectStack(`1 2 3 pop`, [1, 2], "pop_3");
-});
-test('should support labels via tokenizer', () => {
-    const vm = createVMAndRunCode(`1 "Awesome" goto 2 3 #Awesome nop`);
-    expect(vm.labelMap["Awesome"]).toBe(4);
-    expect(vm.stack).toEqual([1, 3]);
-});
-test('should support the`stacksize opcode', () => {
-    expectStack(`"f" "o" "o" stacksize`, ["f", "o", "o", 3], "stacksize_0");
-    expectStack(`stacksize`, [0], "stacksize_1");
-});
-test('should support Standard Representation code', () => {
-    expect(createVMAndRunStdRepCode([
-        {
-            "type": "push-number-instruction",
-            "value": 42
-        },
-        {
-            "type": "push-number-instruction",
-            "value": 8
-        },
-        {
-            "type": "invoke-function-instruction",
-            "functionName": "+"
-        },
-        {
-            "type": "push-string-instruction",
-            "value": "Foo"
-        },
-        {
-            "type": "invoke-function-instruction",
-            "functionName": "setContext"
-        }
-    ]).context).toEqual({ "Foo": 50 });
-});
-test('should support labels in Standard Representation code', () => {
-    expect(createVMAndRunStdRepCode([
-        {
-            "type": "push-number-instruction",
-            "value": 1
-        },
-        {
-            "type": "push-string-instruction",
-            "value": "Awesome"
-        },
-        {
-            "type": "invoke-function-instruction",
-            "functionName": "goto"
-        },
-        {
-            "type": "push-number-instruction",
-            "value": 2,
-            "comment": "Due to the goto above, this instruction will be skipped, and so 2 won't be pushed to the stack"
-        },
-        {
-            "type": "push-number-instruction",
-            "value": 3,
-            "label": "Awesome"
-        },
-        {
-            "type": "invoke-function-instruction",
-            "functionName": "nop"
-        }
-    ]).stack).toEqual([1, 3]);
-});
-test('example tests', () => {
-    expectStack(`1 1 + 2 eq jgz { "1 + 1 = 2!" }`, ["1 + 1 = 2!"], "example_0");
-    expectStack(`1 1 + 2 eq dup jgz { "1 + 1 = 2!" pop } jz { "1 + 1 is not 2!?" }`, [], "example_1");
-    expectStack(`1 1 + 2 eq "conditionResult" setContext "conditionResult" getContext jgz { "1 + 1 = 2!" } "conditionResult" getContext jz { "1 + 1 is not 2!?" }`, ["1 + 1 = 2!"], "example_2");
-    expectStack(`"Hello" "," " world!" rconcat rconcat`, ["Hello, world!"], "example_3");
-    expectStack(`1 2 3 4 "hi" 0 -1 0 0 1 1 stacksize jgz { pop } stacksize jgz { 9 ppc - goto }`, [], "example_4");
-});
-test('poor man\'s function', () => {
-    expectVM(`
-    {
-      nop #mul3
-      "_mul3_return_pc" setContext
-      3 *
-      "_mul3_return_pc" getContext 3 + "_mul3_return_pc" delContext goto
-    }
-    1 ppc "mul3" goto
-    2 ppc "mul3" goto
-    3 ppc "mul3" goto
-    4 ppc "mul3" goto
-    `, {}, {
-        stack: [3, 6, 9, 12],
-        context: {}
-    }, 'poor_mans_function');
-});
-test('stdout', () => {
-    const stdOut = jest_mock_process_1.mockProcessStdout();
-    expectStack(`1 stdout`, [], "stdout_0");
-    expect(stdOut).toHaveBeenCalledWith('1');
-    expectStack(`"hello" stdout`, [], "stdout_1");
-    expect(stdOut).toHaveBeenCalledWith('hello');
-    stdOut.mockRestore();
-});
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const vm_1 = require("./vm");
+const tokenizer_1 = require("./util/tokenizer");
+const jest_mock_process_1 = require("jest-mock-process");
+const fs_1 = __importDefault(require("fs"));
+const EMIT_TEST_JSONS = true; // set to true to emit test jsons in `src/tests`
+if (EMIT_TEST_JSONS) {
+    // clean folder first!
+    const files = fs_1.default.readdirSync("./src/tests");
+    files.forEach(f => {
+        fs_1.default.unlinkSync(`./src/tests/${f}`);
+    });
+}
+function createVMAndRunStdRepCode(instructions, initialContext, initialLabelMap) {
+    if (initialLabelMap === undefined) {
+        initialLabelMap = {};
+    }
+    const vm = new vm_1.VM(initialContext !== undefined ? initialContext : {});
+    vm.loadProgramList(instructions, initialLabelMap);
+    vm.run();
+    return vm;
+}
+function createVM(codeBlock, initialContext, initialLabelMap) {
+    if (initialLabelMap === undefined) {
+        initialLabelMap = {};
+    }
+    const vm = new vm_1.VM(initialContext !== undefined ? initialContext : {});
+    const tokenizer = new tokenizer_1.Tokenizer();
+    const instructions = tokenizer.parse(codeBlock);
+    vm.loadProgramList(instructions, initialLabelMap);
+    return { vm, instructions };
+}
+function createVMAndRunCode(codeBlock, initialContext, initialLabelMap) {
+    const { vm } = createVM(codeBlock, initialContext, initialLabelMap);
+    vm.run();
+    return vm;
+}
+let lastTest = 0;
+function expectVM(codeBlock, initialContext, expectations, testname) {
+    const { instructions, vm } = createVM(codeBlock, initialContext);
+    let usedTestName = testname;
+    if (testname === undefined) {
+        usedTestName = "" + lastTest;
+        lastTest += 1;
+    }
+    if (EMIT_TEST_JSONS) {
+        fs_1.default.writeFileSync(`./src/tests/${usedTestName}.json`, JSON.stringify({
+            input_program: instructions,
+            initial_context: initialContext,
+            expected: {
+                stack: expectations.stack,
+                context: expectations.context,
+                programCounter: expectations.programCounter
+            }
+        }, null, 2));
+    }
+    vm.run();
+    if (expectations.stack !== undefined) {
+        expect(vm.stack).toEqual(expectations.stack);
+    }
+    if (expectations.context !== undefined) {
+        expect(vm.context).toEqual(expectations.context);
+    }
+    if (expectations.programCounter !== undefined) {
+        expect(vm.programCounter).toEqual(expectations.programCounter);
+    }
+}
+function expectStack(codeBlock, expectedStack, testname) {
+    expectVM(codeBlock, {}, {
+        stack: expectedStack
+    }, testname);
+}
+test('should have an initial state', () => {
+    const vm = new vm_1.VM({});
+    expect(vm.programCounter).toBe(0);
+    expect(vm.context).toEqual({});
+    expect(vm.labelMap).toEqual({});
+    expect(vm.programList).toEqual([]);
+    expect(vm.stack).toEqual([]);
+    expect(vm.exit).toBe(false);
+    expect(vm.pause).toBe(false);
+});
+test('should push numbers to the stack', () => {
+    expectStack(`1 2 3`, [1, 2, 3], "push_numbers");
+    expectStack(`-1 -2 -3`, [-1, -2, -3], "push_negative_numbers");
+});
+test('should push strings to the stack', () => {
+    expectStack(`"foo" "bar" "baz"`, ["foo", "bar", "baz"], "push_strings");
+});
+test('should set context', () => {
+    expectVM(`"FOO" "bar" setContext`, {}, { context: { bar: "FOO" } }, "setContext_string");
+    expectVM(`1 "bar" setContext`, {}, { context: { bar: 1 } }, "setContext_number");
+});
+test('should get context', () => {
+    const ctx = { "ham": "ster", "one": 1, "two": 2 };
+    expectVM(`"ham" getContext`, ctx, { stack: ["ster"] }, "getContext_1");
+    expectVM(`"one" getContext`, ctx, { stack: [1] }, "getContext_2");
+    expectVM(`"two" getContext`, ctx, { stack: [2] }, "getContext_3");
+});
+test('should be able to text if context variable exists', () => {
+    const ctx = { "ham": "ster", "one": 1, "two": 2 };
+    expectVM(`"ham" hasContext`, ctx, { stack: [1] }, "hasContext_1");
+    expectVM(`"one" hasContext`, ctx, { stack: [1] }, "hasContext_2");
+    expectVM(`"foobar" hasContext`, ctx, { stack: [0] }, "hasContext_3");
+});
+test('should delete context', () => {
+    expectVM(`"FOO" "bar" setContext "bar" delContext`, {}, { context: {} }, "delContext");
+});
+test('should throw an error when trying to get context for unknown variables', () => {
+    const ctx = { "ham": "ster", "one": 1, "two": 2 };
+    expect(() => createVMAndRunCode(`"asdfzxc" getContext`, ctx)).toThrow();
+});
+test('should throw an error when using a non-string key for context operations', () => {
+    const ctx = { "ham": "ster", "one": 1, "two": 2 };
+    // the key is the top of the stack, so a numeric key means the number is last pushed
+    expect(() => createVMAndRunCode(`"value" 5 setContext`, ctx)).toThrow();
+    expect(() => createVMAndRunCode(`5 getContext`, ctx)).toThrow();
+    expect(() => createVMAndRunCode(`5 hasContext`, ctx)).toThrow();
+    expect(() => createVMAndRunCode(`5 delContext`, ctx)).toThrow();
+});
+test('should throw an error when adding/subtracting/multiplying non-numbers', () => {
+    expect(() => createVMAndRunCode(`"foo" 1 +`, {})).toThrow();
+    expect(() => createVMAndRunCode(`1 "foo" +`, {})).toThrow();
+    expect(() => createVMAndRunCode(`"foo" 1 -`, {})).toThrow();
+    expect(() => createVMAndRunCode(`"foo" 1 *`, {})).toThrow();
+});
+test('randInt with max 0 should push 0 without throwing', () => {
+    expectStack(`0 randInt`, [0], "randint_zero");
+});
+test('charCode should map full code points like String.fromCharCode', () => {
+    expectStack(`97 charCode`, ["a"], "charcode_ascii");
+    expectStack(`256 charCode`, ["Ā"], "charcode_codepoint");
+});
+test('comparison and jump ops should use float semantics, not integer truncation', () => {
+    // concise syntax now parses floats too, so these use decimal literals directly
+    expectStack(`0.1 0.9 gt`, [1], "gt_fractional");
+    expectStack(`0.9 0.1 lt`, [1], "lt_fractional");
+    expectStack(`0.5 jgz 99`, [], "jgz_fractional_skip");
+    expectStack(`0.5 jz 99`, [99], "jz_fractional_no_skip");
+});
+test('concise syntax should parse decimal number literals', () => {
+    expectStack(`1.5 2.5 +`, [4], "decimal_parse_add");
+    expectStack(`0.5 0.5 +`, [1], "decimal_parse_add2");
+});
+test('should add numbers', () => {
+    expectStack(`1 2 +`, [3], "plus_0");
+    expectStack(`1 2 plus`, [3], "plus_1");
+});
+test('should subtract numbers', () => {
+    expectStack(`1 2 -`, [1], "min_0");
+    expectStack(`1 2 min`, [1], "min_1");
+    expectStack(`1 10 min`, [9], "min_2");
+});
+test('should multiply numbers', () => {
+    expectStack(`2 3 *`, [6], "multiply_0");
+    expectStack(`2 3 mul`, [6], "multiply_1");
+});
+test('should support the not instruction', () => {
+    expectStack(`0 not`, [1], "not_0");
+    expectStack(`1 not`, [0], "not_1");
+    expectStack(`42 not`, [0], "not_2");
+});
+test('should support jgz, { and } for jgz-style if statements', () => {
+    expectStack(`1 jgz { "EXPECT_THIS" } "AND_THIS"`, ["EXPECT_THIS", "AND_THIS"], "if_jgz_0");
+    expectStack(`0 jgz { "EXPECT_NOT_THIS" } "EXPECT_ONLY_THIS"`, ["EXPECT_ONLY_THIS"], "if_jgz_1");
+});
+test('should support jz', () => {
+    expectStack(`0 jz "no"`, [], "jz_0");
+    expectStack(`1 jz "yes"`, ["yes"], "jz_1");
+    expectStack(`-1 jz "yes"`, ["yes"], "jz_2");
+});
+test('should support jgz', () => {
+    expectStack(`0 jgz "yes"`, ["yes"], "jgz_0");
+    expectStack(`-1 jgz "yes"`, ["yes"], "jgz_1");
+    expectStack(`1 jgz "no"`, [], "jgz_2");
+});
+test('should support braces', () => {
+    expectStack(`1 2 { 3 4 5 } 6 7`, [1, 2, 6, 7], "braces");
+});
+test('should support nested braces', () => {
+    expectStack(`1 2 { 3 { 4 5 } 6 } 7`, [1, 2, 7], "braces_nested");
+});
+test('should support the goto instruction', () => {
+    expectStack(`5 goto "foo" "bar" "baz" "quux" exit`, ["quux"], "goto_by_number");
+    expectStack(`"myLabel" goto "foo" "bar" "baz" "quux" #myLabel exit`, ["quux"], "goto_by_label");
+    expect(createVMAndRunCode(`"myLabel" goto "foo" "bar" "baz" "quux" exit`, {}, { myLabel: 5 }).stack).toEqual(["quux"]);
+});
+test('should calculate equality between values on the stack', () => {
+    expectStack(`1 1 eq`, [1], "eq_0"); // equal
+    expectStack(`0 0 eq`, [1], "eq_1"); // equal
+    expectStack(`"foo" "foo" eq`, [1], "eq_2"); // equal
+    expectStack(`"foo" "bar" eq`, [0], "eq_3"); // not equal
+    expectStack(`1 2 eq`, [0], "eq_4"); // not equal
+    expectStack(`2 1 eq`, [0], "eq_5"); // not equal
+    expectStack(`"0" 0 eq`, [0], "eq_6"); // not equal
+});
+test('should calculate greater than', () => {
+    expectStack(`1 1 gt`, [0], 'gt_0'); // not greater than
+    expectStack(`1 0 gt`, [0], 'gt_1'); // not greater than
+    expectStack(`1 2 gt`, [1], 'gt_2'); // greater than
+    expectStack(`1 -2 gt`, [0], 'gt_3'); // not greater than
+    expectStack(`-1 2 gt`, [1], 'gt_4'); // greater than
+    expectStack(`-1 -2 gt`, [0], 'gt_5'); // not greater than
+    expectStack(`-2 -1 gt`, [1], 'gt_6'); // greater than
+    expectStack(`-2 -2 gt`, [0], 'gt_7'); // not greater than
+});
+test('should calculate less than', () => {
+    expectStack(`1 1 lt`, [0], 'lt_0'); // not less than
+    expectStack(`1 2 lt`, [0], 'lt_1'); // not less than
+    expectStack(`1 0 lt`, [1], 'lt_2'); // less than
+    expectStack(`1 -1 lt`, [1], 'lt_3'); // less than
+    expectStack(`-1 -1 lt`, [0], 'lt_4'); // not less than
+    expectStack(`-1 -2 lt`, [1], 'lt_5'); // not less than
+    expectStack(`-1 2 lt`, [0], 'lt_6'); // not less than
+    expectStack(`2 -1 lt`, [1], 'lt_7'); // not less than
+});
+test('should concat', () => {
+    expectStack(`"one" "two" concat`, ["twoone"], "concat_0");
+    expectStack(`"1" "two" concat`, ["two1"], "concat_1");
+    expectStack(`1 2 concat`, ["21"], "concat_2");
+    expectStack(`"one" 2 concat`, ["2one"], "concat_3");
+});
+test('should rconcat (reverse concat)', () => {
+    expectStack(`"one" "two" rconcat`, ["onetwo"], "rconcat_0");
+    expectStack(`"1" "two" rconcat`, ["1two"], "rconcat_1");
+    expectStack(`1 2 rconcat`, ["12"], "rconcat_2");
+    expectStack(`"one" 2 rconcat`, ["one2"], "rconcat_3");
+});
+test('should pause', () => {
+    const vm = createVMAndRunCode(`"foo" "bar" pause "baz" "quux"`);
+    expect(vm.stack).toEqual(["foo", "bar"]);
+    expect(vm.pause).toEqual(true);
+    expect(vm.exit).toEqual(false);
+    expect(vm.programCounter).toEqual(3); // pause WILL increment the programCounter!
+    vm.run();
+    expect(vm.stack).toEqual(["foo", "bar", "baz", "quux"]);
+    expect(vm.pause).toEqual(false);
+    expect(vm.exit).toEqual(true);
+    expect(vm.programCounter).toEqual(5);
+});
+test('should exit', () => {
+    const vm = createVMAndRunCode(`"foo" "bar" exit "baz" "quux"`);
+    expect(vm.stack).toEqual(["foo", "bar"]);
+    expect(vm.pause).toEqual(false);
+    expect(vm.exit).toEqual(true);
+    expect(vm.programCounter).toEqual(3); // exit WILL increment the programCounter!
+    vm.run(); // this is a no-op, effectively, as the VM can not run anymore!
+    expect(vm.stack).toEqual(["foo", "bar"]);
+    expect(vm.pause).toEqual(false);
+    expect(vm.exit).toEqual(true);
+    expect(vm.programCounter).toEqual(3);
+});
+test('should push program counter on ppc instruction', () => {
+    expectStack(`nop nop ppc`, [2], "ppc_0");
+    expectStack(`ppc`, [0], "ppc_1");
+});
+test('should do nothing on nop instruction', () => {
+    expectStack(`nop nop nop`, [], "nop_0");
+    expectVM(`nop`, {}, { programCounter: 1, context: {}, stack: [] }, "nop_1");
+});
+test('should calculate and', () => {
+    expectStack(`1 1 and`, [1], "and_0");
+    expectStack(`1 0 and`, [0], "and_1");
+    expectStack(`0 1 and`, [0], "and_2");
+    expectStack(`0 0 and`, [0], "and_3");
+    expectStack(`1 9 and`, [1], "and_4");
+    expectStack(`9 1 and`, [1], "and_5");
+});
+test('should calculate or', () => {
+    expectStack(`1 1 or`, [1], "or_0");
+    expectStack(`1 0 or`, [1], "or_1");
+    expectStack(`0 1 or`, [1], "or_2");
+    expectStack(`0 0 or`, [0], "or_3");
+    expectStack(`1 9 or`, [1], "or_4");
+    expectStack(`9 1 or`, [1], "or_5");
+});
+test('should duplicate top item from stack via dup', () => {
+    expectStack(`1 dup`, [1, 1], "dup_0");
+    expectStack(`0 dup`, [0, 0], "dup_1");
+    expectStack(`"test" dup`, ["test", "test"], "dup_2");
+    expectStack(`42 dup`, [42, 42], "dup_3");
+});
+test('should pop top item from stack via pop', () => {
+    expectStack(`1 pop`, [], "pop_0");
+    expectStack(`0 pop`, [], "pop_1");
+    expectStack(`"test" pop`, [], "pop_2");
+    expectStack(`1 2 3 pop`, [1, 2], "pop_3");
+});
+test('should support labels via tokenizer', () => {
+    const vm = createVMAndRunCode(`1 "Awesome" goto 2 3 #Awesome nop`);
+    expect(vm.labelMap["Awesome"]).toBe(4);
+    expect(vm.stack).toEqual([1, 3]);
+});
+test('should support the`stacksize opcode', () => {
+    expectStack(`"f" "o" "o" stacksize`, ["f", "o", "o", 3], "stacksize_0");
+    expectStack(`stacksize`, [0], "stacksize_1");
+});
+test('should support Standard Representation code', () => {
+    expect(createVMAndRunStdRepCode([
+        {
+            "type": "push-number-instruction",
+            "value": 42
+        },
+        {
+            "type": "push-number-instruction",
+            "value": 8
+        },
+        {
+            "type": "invoke-function-instruction",
+            "functionName": "+"
+        },
+        {
+            "type": "push-string-instruction",
+            "value": "Foo"
+        },
+        {
+            "type": "invoke-function-instruction",
+            "functionName": "setContext"
+        }
+    ]).context).toEqual({ "Foo": 50 });
+});
+test('should support labels in Standard Representation code', () => {
+    expect(createVMAndRunStdRepCode([
+        {
+            "type": "push-number-instruction",
+            "value": 1
+        },
+        {
+            "type": "push-string-instruction",
+            "value": "Awesome"
+        },
+        {
+            "type": "invoke-function-instruction",
+            "functionName": "goto"
+        },
+        {
+            "type": "push-number-instruction",
+            "value": 2,
+            "comment": "Due to the goto above, this instruction will be skipped, and so 2 won't be pushed to the stack"
+        },
+        {
+            "type": "push-number-instruction",
+            "value": 3,
+            "label": "Awesome"
+        },
+        {
+            "type": "invoke-function-instruction",
+            "functionName": "nop"
+        }
+    ]).stack).toEqual([1, 3]);
+});
+test('example tests', () => {
+    expectStack(`1 1 + 2 eq jgz { "1 + 1 = 2!" }`, ["1 + 1 = 2!"], "example_0");
+    expectStack(`1 1 + 2 eq dup jgz { "1 + 1 = 2!" pop } jz { "1 + 1 is not 2!?" }`, [], "example_1");
+    expectStack(`1 1 + 2 eq "conditionResult" setContext "conditionResult" getContext jgz { "1 + 1 = 2!" } "conditionResult" getContext jz { "1 + 1 is not 2!?" }`, ["1 + 1 = 2!"], "example_2");
+    expectStack(`"Hello" "," " world!" rconcat rconcat`, ["Hello, world!"], "example_3");
+    expectStack(`1 2 3 4 "hi" 0 -1 0 0 1 1 stacksize jgz { pop } stacksize jgz { 9 ppc - goto }`, [], "example_4");
+});
+test('poor man\'s function', () => {
+    expectVM(`
+    {
+      nop #mul3
+      "_mul3_return_pc" setContext
+      3 *
+      "_mul3_return_pc" getContext 3 + "_mul3_return_pc" delContext goto
+    }
+    1 ppc "mul3" goto
+    2 ppc "mul3" goto
+    3 ppc "mul3" goto
+    4 ppc "mul3" goto
+    `, {}, {
+        stack: [3, 6, 9, 12],
+        context: {}
+    }, 'poor_mans_function');
+});
+test('stdout', () => {
+    const stdOut = jest_mock_process_1.mockProcessStdout();
+    expectStack(`1 stdout`, [], "stdout_0");
+    expect(stdOut).toHaveBeenCalledWith('1');
+    expectStack(`"hello" stdout`, [], "stdout_1");
+    expect(stdOut).toHaveBeenCalledWith('hello');
+    stdOut.mockRestore();
+});
+test('stdout should coerce values like JavaScript (negative zero and empty stack)', () => {
+    const stdOut = jest_mock_process_1.mockProcessStdout();
+    // -1 0 * evaluates to -0, and "" + -0 === "0" in JavaScript
+    createVMAndRunCode(`-1 0 * stdout`);
+    expect(stdOut).toHaveBeenCalledWith('0');
+    stdOut.mockClear();
+    // popping from an empty stack yields undefined, and "" + undefined === "undefined"
+    createVMAndRunCode(`stdout`);
+    expect(stdOut).toHaveBeenCalledWith('undefined');
+    stdOut.mockRestore();
+});
 //# sourceMappingURL=vm.test.js.map