@jspsych/test-utils 1.0.0 → 1.1.0

package/dist/index.cjs

@@ -50,6 +50,51 @@ function mouseDownMouseUpTarget(target) {
 function clickTarget(target) {
     target.dispatchEvent(new MouseEvent("click", { bubbles: true }));
 }
+/**
+ * Dispatch a `mousemove` event, with x and y defined relative to the container element.
+ * @param x The x location of the event, relative to the x location of `container`.
+ * @param y The y location of the event, relative to the y location of `container`.
+ * @param container The DOM element for relative location of the event.
+ */
+function mouseMove(x, y, container) {
+    const containerRect = container.getBoundingClientRect();
+    const eventInit = {
+        clientX: containerRect.x + x,
+        clientY: containerRect.y + y,
+        bubbles: true,
+    };
+    container.dispatchEvent(new MouseEvent("mousemove", eventInit));
+}
+/**
+ * Dispatch a `mouseup` event, with x and y defined relative to the container element.
+ * @param x The x location of the event, relative to the x location of `container`.
+ * @param y The y location of the event, relative to the y location of `container`.
+ * @param container The DOM element for relative location of the event.
+ */
+function mouseUp(x, y, container) {
+    const containerRect = container.getBoundingClientRect();
+    const eventInit = {
+        clientX: containerRect.x + x,
+        clientY: containerRect.y + y,
+        bubbles: true,
+    };
+    container.dispatchEvent(new MouseEvent("mouseup", eventInit));
+}
+/**
+ * Dispatch a `mousemove` event, with x and y defined relative to the container element.
+ * @param x The x location of the event, relative to the x location of `container`.
+ * @param y The y location of the event, relative to the y location of `container`.
+ * @param container The DOM element for relative location of the event.
+ */
+function mouseDown(x, y, container) {
+    const containerRect = container.getBoundingClientRect();
+    const eventInit = {
+        clientX: containerRect.x + x,
+        clientY: containerRect.y + y,
+        bubbles: true,
+    };
+    container.dispatchEvent(new MouseEvent("mousedown", eventInit));
+}
 /**
  * https://github.com/facebook/jest/issues/2157#issuecomment-279171856
  */
@@ -94,6 +139,49 @@ function startTimeline(timeline, jsPsych = {}) {
             finished,
         };
     });
+}
+/**
+ * Runs the given timeline by calling `jsPsych.simulate()` on the provided JsPsych object.
+ *
+ * @param timeline The timeline that is passed to `jsPsych.run()`
+ * @param simulation_mode Either 'data-only' mode or 'visual' mode.
+ * @param simulation_options Options to pass to `jsPsych.simulate()`
+ * @param jsPsych The jsPsych instance to be used. If left empty, a new instance will be created. If
+ * a settings object is passed instead, the settings will be used to create the jsPsych instance.
+ *
+ * @returns An object containing test helper functions, the jsPsych instance, and the jsPsych
+ * display element
+ */
+function simulateTimeline(timeline, simulation_mode = "data-only", simulation_options = {}, jsPsych = {}) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const jsPsychInstance = jsPsych instanceof jspsych.JsPsych ? jsPsych : new jspsych.JsPsych(jsPsych);
+        let hasFinished = false;
+        const finished = jsPsychInstance
+            .simulate(timeline, simulation_mode, simulation_options)
+            .then(() => {
+            hasFinished = true;
+        });
+        yield flushPromises();
+        const displayElement = jsPsychInstance.getDisplayElement();
+        return {
+            jsPsych: jsPsychInstance,
+            displayElement,
+            /** Shorthand for `jsPsych.getDisplayElement().innerHTML` */
+            getHTML: () => displayElement.innerHTML,
+            /** Shorthand for `jsPsych.data.get()` */
+            getData: () => jsPsychInstance.data.get(),
+            expectFinished: () => __awaiter(this, void 0, void 0, function* () {
+                yield flushPromises();
+                expect(hasFinished).toBe(true);
+            }),
+            expectRunning: () => __awaiter(this, void 0, void 0, function* () {
+                yield flushPromises();
+                expect(hasFinished).toBe(false);
+            }),
+            /** A promise that is resolved when `jsPsych.simulate()` is done. */
+            finished,
+        };
+    });
 }
 
 exports.clickTarget = clickTarget;
@@ -101,7 +189,11 @@ exports.dispatchEvent = dispatchEvent;
 exports.flushPromises = flushPromises;
 exports.keyDown = keyDown;
 exports.keyUp = keyUp;
+exports.mouseDown = mouseDown;
 exports.mouseDownMouseUpTarget = mouseDownMouseUpTarget;
+exports.mouseMove = mouseMove;
+exports.mouseUp = mouseUp;
 exports.pressKey = pressKey;
+exports.simulateTimeline = simulateTimeline;
 exports.startTimeline = startTimeline;
 //# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","sources":["../../../node_modules/tslib/tslib.es6.js","../src/index.ts"],"sourcesContent":["/*! *****************************************************************************\r\nCopyright (c) Microsoft Corporation.\r\n\r\nPermission to use, copy, modify, and/or distribute this software for any\r\npurpose with or without fee is hereby granted.\r\n\r\nTHE SOFTWARE IS PROVIDED \"AS IS\" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH\r\nREGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY\r\nAND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT,\r\nINDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM\r\nLOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR\r\nOTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR\r\nPERFORMANCE OF THIS SOFTWARE.\r\n***************************************************************************** */\r\n/* global Reflect, Promise */\r\n\r\nvar extendStatics = function(d, b) {\r\n    extendStatics = Object.setPrototypeOf ||\r\n        ({ __proto__: [] } instanceof Array && function (d, b) { d.__proto__ = b; }) ||\r\n        function (d, b) { for (var p in b) if (Object.prototype.hasOwnProperty.call(b, p)) d[p] = b[p]; };\r\n    return extendStatics(d, b);\r\n};\r\n\r\nexport function __extends(d, b) {\r\n    if (typeof b !== \"function\" && b !== null)\r\n        throw new TypeError(\"Class extends value \" + String(b) + \" is not a constructor or null\");\r\n    extendStatics(d, b);\r\n    function __() { this.constructor = d; }\r\n    d.prototype = b === null ? Object.create(b) : (__.prototype = b.prototype, new __());\r\n}\r\n\r\nexport var __assign = function() {\r\n    __assign = Object.assign || function __assign(t) {\r\n        for (var s, i = 1, n = arguments.length; i < n; i++) {\r\n            s = arguments[i];\r\n            for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p)) t[p] = s[p];\r\n        }\r\n        return t;\r\n    }\r\n    return __assign.apply(this, arguments);\r\n}\r\n\r\nexport function __rest(s, e) {\r\n    var t = {};\r\n    for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p) && e.indexOf(p) < 0)\r\n        t[p] = s[p];\r\n    if (s != null && typeof Object.getOwnPropertySymbols === \"function\")\r\n        for (var i = 0, p = Object.getOwnPropertySymbols(s); i < p.length; i++) {\r\n            if (e.indexOf(p[i]) < 0 && Object.prototype.propertyIsEnumerable.call(s, p[i]))\r\n                t[p[i]] = s[p[i]];\r\n        }\r\n    return t;\r\n}\r\n\r\nexport function __decorate(decorators, target, key, desc) {\r\n    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;\r\n    if (typeof Reflect === \"object\" && typeof Reflect.decorate === \"function\") r = Reflect.decorate(decorators, target, key, desc);\r\n    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;\r\n    return c > 3 && r && Object.defineProperty(target, key, r), r;\r\n}\r\n\r\nexport function __param(paramIndex, decorator) {\r\n    return function (target, key) { decorator(target, key, paramIndex); }\r\n}\r\n\r\nexport function __metadata(metadataKey, metadataValue) {\r\n    if (typeof Reflect === \"object\" && typeof Reflect.metadata === \"function\") return Reflect.metadata(metadataKey, metadataValue);\r\n}\r\n\r\nexport function __awaiter(thisArg, _arguments, P, generator) {\r\n    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }\r\n    return new (P || (P = Promise))(function (resolve, reject) {\r\n        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }\r\n        function rejected(value) { try { step(generator[\"throw\"](value)); } catch (e) { reject(e); } }\r\n        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }\r\n        step((generator = generator.apply(thisArg, _arguments || [])).next());\r\n    });\r\n}\r\n\r\nexport function __generator(thisArg, body) {\r\n    var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g;\r\n    return g = { next: verb(0), \"throw\": verb(1), \"return\": verb(2) }, typeof Symbol === \"function\" && (g[Symbol.iterator] = function() { return this; }), g;\r\n    function verb(n) { return function (v) { return step([n, v]); }; }\r\n    function step(op) {\r\n        if (f) throw new TypeError(\"Generator is already executing.\");\r\n        while (_) try {\r\n            if (f = 1, y && (t = op[0] & 2 ? y[\"return\"] : op[0] ? y[\"throw\"] || ((t = y[\"return\"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;\r\n            if (y = 0, t) op = [op[0] & 2, t.value];\r\n            switch (op[0]) {\r\n                case 0: case 1: t = op; break;\r\n                case 4: _.label++; return { value: op[1], done: false };\r\n                case 5: _.label++; y = op[1]; op = [0]; continue;\r\n                case 7: op = _.ops.pop(); _.trys.pop(); continue;\r\n                default:\r\n                    if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }\r\n                    if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }\r\n                    if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }\r\n                    if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }\r\n                    if (t[2]) _.ops.pop();\r\n                    _.trys.pop(); continue;\r\n            }\r\n            op = body.call(thisArg, _);\r\n        } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }\r\n        if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };\r\n    }\r\n}\r\n\r\nexport var __createBinding = Object.create ? (function(o, m, k, k2) {\r\n    if (k2 === undefined) k2 = k;\r\n    Object.defineProperty(o, k2, { enumerable: true, get: function() { return m[k]; } });\r\n}) : (function(o, m, k, k2) {\r\n    if (k2 === undefined) k2 = k;\r\n    o[k2] = m[k];\r\n});\r\n\r\nexport function __exportStar(m, o) {\r\n    for (var p in m) if (p !== \"default\" && !Object.prototype.hasOwnProperty.call(o, p)) __createBinding(o, m, p);\r\n}\r\n\r\nexport function __values(o) {\r\n    var s = typeof Symbol === \"function\" && Symbol.iterator, m = s && o[s], i = 0;\r\n    if (m) return m.call(o);\r\n    if (o && typeof o.length === \"number\") return {\r\n        next: function () {\r\n            if (o && i >= o.length) o = void 0;\r\n            return { value: o && o[i++], done: !o };\r\n        }\r\n    };\r\n    throw new TypeError(s ? \"Object is not iterable.\" : \"Symbol.iterator is not defined.\");\r\n}\r\n\r\nexport function __read(o, n) {\r\n    var m = typeof Symbol === \"function\" && o[Symbol.iterator];\r\n    if (!m) return o;\r\n    var i = m.call(o), r, ar = [], e;\r\n    try {\r\n        while ((n === void 0 || n-- > 0) && !(r = i.next()).done) ar.push(r.value);\r\n    }\r\n    catch (error) { e = { error: error }; }\r\n    finally {\r\n        try {\r\n            if (r && !r.done && (m = i[\"return\"])) m.call(i);\r\n        }\r\n        finally { if (e) throw e.error; }\r\n    }\r\n    return ar;\r\n}\r\n\r\n/** @deprecated */\r\nexport function __spread() {\r\n    for (var ar = [], i = 0; i < arguments.length; i++)\r\n        ar = ar.concat(__read(arguments[i]));\r\n    return ar;\r\n}\r\n\r\n/** @deprecated */\r\nexport function __spreadArrays() {\r\n    for (var s = 0, i = 0, il = arguments.length; i < il; i++) s += arguments[i].length;\r\n    for (var r = Array(s), k = 0, i = 0; i < il; i++)\r\n        for (var a = arguments[i], j = 0, jl = a.length; j < jl; j++, k++)\r\n            r[k] = a[j];\r\n    return r;\r\n}\r\n\r\nexport function __spreadArray(to, from, pack) {\r\n    if (pack || arguments.length === 2) for (var i = 0, l = from.length, ar; i < l; i++) {\r\n        if (ar || !(i in from)) {\r\n            if (!ar) ar = Array.prototype.slice.call(from, 0, i);\r\n            ar[i] = from[i];\r\n        }\r\n    }\r\n    return to.concat(ar || Array.prototype.slice.call(from));\r\n}\r\n\r\nexport function __await(v) {\r\n    return this instanceof __await ? (this.v = v, this) : new __await(v);\r\n}\r\n\r\nexport function __asyncGenerator(thisArg, _arguments, generator) {\r\n    if (!Symbol.asyncIterator) throw new TypeError(\"Symbol.asyncIterator is not defined.\");\r\n    var g = generator.apply(thisArg, _arguments || []), i, q = [];\r\n    return i = {}, verb(\"next\"), verb(\"throw\"), verb(\"return\"), i[Symbol.asyncIterator] = function () { return this; }, i;\r\n    function verb(n) { if (g[n]) i[n] = function (v) { return new Promise(function (a, b) { q.push([n, v, a, b]) > 1 || resume(n, v); }); }; }\r\n    function resume(n, v) { try { step(g[n](v)); } catch (e) { settle(q[0][3], e); } }\r\n    function step(r) { r.value instanceof __await ? Promise.resolve(r.value.v).then(fulfill, reject) : settle(q[0][2], r); }\r\n    function fulfill(value) { resume(\"next\", value); }\r\n    function reject(value) { resume(\"throw\", value); }\r\n    function settle(f, v) { if (f(v), q.shift(), q.length) resume(q[0][0], q[0][1]); }\r\n}\r\n\r\nexport function __asyncDelegator(o) {\r\n    var i, p;\r\n    return i = {}, verb(\"next\"), verb(\"throw\", function (e) { throw e; }), verb(\"return\"), i[Symbol.iterator] = function () { return this; }, i;\r\n    function verb(n, f) { i[n] = o[n] ? function (v) { return (p = !p) ? { value: __await(o[n](v)), done: n === \"return\" } : f ? f(v) : v; } : f; }\r\n}\r\n\r\nexport function __asyncValues(o) {\r\n    if (!Symbol.asyncIterator) throw new TypeError(\"Symbol.asyncIterator is not defined.\");\r\n    var m = o[Symbol.asyncIterator], i;\r\n    return m ? m.call(o) : (o = typeof __values === \"function\" ? __values(o) : o[Symbol.iterator](), i = {}, verb(\"next\"), verb(\"throw\"), verb(\"return\"), i[Symbol.asyncIterator] = function () { return this; }, i);\r\n    function verb(n) { i[n] = o[n] && function (v) { return new Promise(function (resolve, reject) { v = o[n](v), settle(resolve, reject, v.done, v.value); }); }; }\r\n    function settle(resolve, reject, d, v) { Promise.resolve(v).then(function(v) { resolve({ value: v, done: d }); }, reject); }\r\n}\r\n\r\nexport function __makeTemplateObject(cooked, raw) {\r\n    if (Object.defineProperty) { Object.defineProperty(cooked, \"raw\", { value: raw }); } else { cooked.raw = raw; }\r\n    return cooked;\r\n};\r\n\r\nvar __setModuleDefault = Object.create ? (function(o, v) {\r\n    Object.defineProperty(o, \"default\", { enumerable: true, value: v });\r\n}) : function(o, v) {\r\n    o[\"default\"] = v;\r\n};\r\n\r\nexport function __importStar(mod) {\r\n    if (mod && mod.__esModule) return mod;\r\n    var result = {};\r\n    if (mod != null) for (var k in mod) if (k !== \"default\" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);\r\n    __setModuleDefault(result, mod);\r\n    return result;\r\n}\r\n\r\nexport function __importDefault(mod) {\r\n    return (mod && mod.__esModule) ? mod : { default: mod };\r\n}\r\n\r\nexport function __classPrivateFieldGet(receiver, state, kind, f) {\r\n    if (kind === \"a\" && !f) throw new TypeError(\"Private accessor was defined without a getter\");\r\n    if (typeof state === \"function\" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError(\"Cannot read private member from an object whose class did not declare it\");\r\n    return kind === \"m\" ? f : kind === \"a\" ? f.call(receiver) : f ? f.value : state.get(receiver);\r\n}\r\n\r\nexport function __classPrivateFieldSet(receiver, state, value, kind, f) {\r\n    if (kind === \"m\") throw new TypeError(\"Private method is not writable\");\r\n    if (kind === \"a\" && !f) throw new TypeError(\"Private accessor was defined without a setter\");\r\n    if (typeof state === \"function\" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError(\"Cannot write private member to an object whose class did not declare it\");\r\n    return (kind === \"a\" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;\r\n}\r\n","import { setImmediate as flushMicroTasks } from \"timers\";\n\nimport { JsPsych } from \"jspsych\";\n\nexport function dispatchEvent(event: Event) {\n  document.body.dispatchEvent(event);\n}\n\nexport function keyDown(key: string) {\n  dispatchEvent(new KeyboardEvent(\"keydown\", { key }));\n}\n\nexport function keyUp(key: string) {\n  dispatchEvent(new KeyboardEvent(\"keyup\", { key }));\n}\n\nexport function pressKey(key: string) {\n  keyDown(key);\n  keyUp(key);\n}\n\nexport function mouseDownMouseUpTarget(target: Element) {\n  target.dispatchEvent(new MouseEvent(\"mousedown\", { bubbles: true }));\n  target.dispatchEvent(new MouseEvent(\"mouseup\", { bubbles: true }));\n}\n\nexport function clickTarget(target: Element) {\n  target.dispatchEvent(new MouseEvent(\"click\", { bubbles: true }));\n}\n\n/**\n * https://github.com/facebook/jest/issues/2157#issuecomment-279171856\n */\nexport function flushPromises() {\n  return new Promise((resolve) => flushMicroTasks(resolve));\n}\n\n/**\n * Runs the given timeline by calling `jsPsych.run()` on the provided JsPsych object.\n *\n * @param timeline The timeline that is passed to `jsPsych.run()`\n * @param jsPsych The jsPsych instance to be used. If left empty, a new instance will be created. If\n * a settings object is passed instead, the settings will be used to create the jsPsych instance.\n *\n * @returns An object containing test helper functions, the jsPsych instance, and the jsPsych\n * display element\n */\nexport async function startTimeline(timeline: any[], jsPsych: JsPsych | any = {}) {\n  const jsPsychInstance = jsPsych instanceof JsPsych ? jsPsych : new JsPsych(jsPsych);\n\n  let hasFinished = false;\n  const finished = jsPsychInstance.run(timeline).then(() => {\n    hasFinished = true;\n  });\n  await flushPromises();\n\n  const displayElement = jsPsychInstance.getDisplayElement();\n\n  return {\n    jsPsych: jsPsychInstance,\n    displayElement,\n    /** Shorthand for `jsPsych.getDisplayElement().innerHTML` */\n    getHTML: () => displayElement.innerHTML,\n    /** Shorthand for `jsPsych.data.get()` */\n    getData: () => jsPsychInstance.data.get(),\n    expectFinished: async () => {\n      await flushPromises();\n      expect(hasFinished).toBe(true);\n    },\n    expectRunning: async () => {\n      await flushPromises();\n      expect(hasFinished).toBe(false);\n    },\n    /** A promise that is resolved when `jsPsych.run()` is done. */\n    finished,\n  };\n}\n"],"names":["flushMicroTasks","JsPsych"],"mappings":"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"}
+{"version":3,"file":"index.cjs","sources":["../../../node_modules/tslib/tslib.es6.js","../src/index.ts"],"sourcesContent":["/*! *****************************************************************************\r\nCopyright (c) Microsoft Corporation.\r\n\r\nPermission to use, copy, modify, and/or distribute this software for any\r\npurpose with or without fee is hereby granted.\r\n\r\nTHE SOFTWARE IS PROVIDED \"AS IS\" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH\r\nREGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY\r\nAND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT,\r\nINDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM\r\nLOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR\r\nOTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR\r\nPERFORMANCE OF THIS SOFTWARE.\r\n***************************************************************************** */\r\n/* global Reflect, Promise */\r\n\r\nvar extendStatics = function(d, b) {\r\n    extendStatics = Object.setPrototypeOf ||\r\n        ({ __proto__: [] } instanceof Array && function (d, b) { d.__proto__ = b; }) ||\r\n        function (d, b) { for (var p in b) if (Object.prototype.hasOwnProperty.call(b, p)) d[p] = b[p]; };\r\n    return extendStatics(d, b);\r\n};\r\n\r\nexport function __extends(d, b) {\r\n    if (typeof b !== \"function\" && b !== null)\r\n        throw new TypeError(\"Class extends value \" + String(b) + \" is not a constructor or null\");\r\n    extendStatics(d, b);\r\n    function __() { this.constructor = d; }\r\n    d.prototype = b === null ? Object.create(b) : (__.prototype = b.prototype, new __());\r\n}\r\n\r\nexport var __assign = function() {\r\n    __assign = Object.assign || function __assign(t) {\r\n        for (var s, i = 1, n = arguments.length; i < n; i++) {\r\n            s = arguments[i];\r\n            for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p)) t[p] = s[p];\r\n        }\r\n        return t;\r\n    }\r\n    return __assign.apply(this, arguments);\r\n}\r\n\r\nexport function __rest(s, e) {\r\n    var t = {};\r\n    for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p) && e.indexOf(p) < 0)\r\n        t[p] = s[p];\r\n    if (s != null && typeof Object.getOwnPropertySymbols === \"function\")\r\n        for (var i = 0, p = Object.getOwnPropertySymbols(s); i < p.length; i++) {\r\n            if (e.indexOf(p[i]) < 0 && Object.prototype.propertyIsEnumerable.call(s, p[i]))\r\n                t[p[i]] = s[p[i]];\r\n        }\r\n    return t;\r\n}\r\n\r\nexport function __decorate(decorators, target, key, desc) {\r\n    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;\r\n    if (typeof Reflect === \"object\" && typeof Reflect.decorate === \"function\") r = Reflect.decorate(decorators, target, key, desc);\r\n    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;\r\n    return c > 3 && r && Object.defineProperty(target, key, r), r;\r\n}\r\n\r\nexport function __param(paramIndex, decorator) {\r\n    return function (target, key) { decorator(target, key, paramIndex); }\r\n}\r\n\r\nexport function __metadata(metadataKey, metadataValue) {\r\n    if (typeof Reflect === \"object\" && typeof Reflect.metadata === \"function\") return Reflect.metadata(metadataKey, metadataValue);\r\n}\r\n\r\nexport function __awaiter(thisArg, _arguments, P, generator) {\r\n    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }\r\n    return new (P || (P = Promise))(function (resolve, reject) {\r\n        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }\r\n        function rejected(value) { try { step(generator[\"throw\"](value)); } catch (e) { reject(e); } }\r\n        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }\r\n        step((generator = generator.apply(thisArg, _arguments || [])).next());\r\n    });\r\n}\r\n\r\nexport function __generator(thisArg, body) {\r\n    var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g;\r\n    return g = { next: verb(0), \"throw\": verb(1), \"return\": verb(2) }, typeof Symbol === \"function\" && (g[Symbol.iterator] = function() { return this; }), g;\r\n    function verb(n) { return function (v) { return step([n, v]); }; }\r\n    function step(op) {\r\n        if (f) throw new TypeError(\"Generator is already executing.\");\r\n        while (_) try {\r\n            if (f = 1, y && (t = op[0] & 2 ? y[\"return\"] : op[0] ? y[\"throw\"] || ((t = y[\"return\"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;\r\n            if (y = 0, t) op = [op[0] & 2, t.value];\r\n            switch (op[0]) {\r\n                case 0: case 1: t = op; break;\r\n                case 4: _.label++; return { value: op[1], done: false };\r\n                case 5: _.label++; y = op[1]; op = [0]; continue;\r\n                case 7: op = _.ops.pop(); _.trys.pop(); continue;\r\n                default:\r\n                    if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }\r\n                    if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }\r\n                    if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }\r\n                    if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }\r\n                    if (t[2]) _.ops.pop();\r\n                    _.trys.pop(); continue;\r\n            }\r\n            op = body.call(thisArg, _);\r\n        } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }\r\n        if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };\r\n    }\r\n}\r\n\r\nexport var __createBinding = Object.create ? (function(o, m, k, k2) {\r\n    if (k2 === undefined) k2 = k;\r\n    Object.defineProperty(o, k2, { enumerable: true, get: function() { return m[k]; } });\r\n}) : (function(o, m, k, k2) {\r\n    if (k2 === undefined) k2 = k;\r\n    o[k2] = m[k];\r\n});\r\n\r\nexport function __exportStar(m, o) {\r\n    for (var p in m) if (p !== \"default\" && !Object.prototype.hasOwnProperty.call(o, p)) __createBinding(o, m, p);\r\n}\r\n\r\nexport function __values(o) {\r\n    var s = typeof Symbol === \"function\" && Symbol.iterator, m = s && o[s], i = 0;\r\n    if (m) return m.call(o);\r\n    if (o && typeof o.length === \"number\") return {\r\n        next: function () {\r\n            if (o && i >= o.length) o = void 0;\r\n            return { value: o && o[i++], done: !o };\r\n        }\r\n    };\r\n    throw new TypeError(s ? \"Object is not iterable.\" : \"Symbol.iterator is not defined.\");\r\n}\r\n\r\nexport function __read(o, n) {\r\n    var m = typeof Symbol === \"function\" && o[Symbol.iterator];\r\n    if (!m) return o;\r\n    var i = m.call(o), r, ar = [], e;\r\n    try {\r\n        while ((n === void 0 || n-- > 0) && !(r = i.next()).done) ar.push(r.value);\r\n    }\r\n    catch (error) { e = { error: error }; }\r\n    finally {\r\n        try {\r\n            if (r && !r.done && (m = i[\"return\"])) m.call(i);\r\n        }\r\n        finally { if (e) throw e.error; }\r\n    }\r\n    return ar;\r\n}\r\n\r\n/** @deprecated */\r\nexport function __spread() {\r\n    for (var ar = [], i = 0; i < arguments.length; i++)\r\n        ar = ar.concat(__read(arguments[i]));\r\n    return ar;\r\n}\r\n\r\n/** @deprecated */\r\nexport function __spreadArrays() {\r\n    for (var s = 0, i = 0, il = arguments.length; i < il; i++) s += arguments[i].length;\r\n    for (var r = Array(s), k = 0, i = 0; i < il; i++)\r\n        for (var a = arguments[i], j = 0, jl = a.length; j < jl; j++, k++)\r\n            r[k] = a[j];\r\n    return r;\r\n}\r\n\r\nexport function __spreadArray(to, from, pack) {\r\n    if (pack || arguments.length === 2) for (var i = 0, l = from.length, ar; i < l; i++) {\r\n        if (ar || !(i in from)) {\r\n            if (!ar) ar = Array.prototype.slice.call(from, 0, i);\r\n            ar[i] = from[i];\r\n        }\r\n    }\r\n    return to.concat(ar || Array.prototype.slice.call(from));\r\n}\r\n\r\nexport function __await(v) {\r\n    return this instanceof __await ? (this.v = v, this) : new __await(v);\r\n}\r\n\r\nexport function __asyncGenerator(thisArg, _arguments, generator) {\r\n    if (!Symbol.asyncIterator) throw new TypeError(\"Symbol.asyncIterator is not defined.\");\r\n    var g = generator.apply(thisArg, _arguments || []), i, q = [];\r\n    return i = {}, verb(\"next\"), verb(\"throw\"), verb(\"return\"), i[Symbol.asyncIterator] = function () { return this; }, i;\r\n    function verb(n) { if (g[n]) i[n] = function (v) { return new Promise(function (a, b) { q.push([n, v, a, b]) > 1 || resume(n, v); }); }; }\r\n    function resume(n, v) { try { step(g[n](v)); } catch (e) { settle(q[0][3], e); } }\r\n    function step(r) { r.value instanceof __await ? Promise.resolve(r.value.v).then(fulfill, reject) : settle(q[0][2], r); }\r\n    function fulfill(value) { resume(\"next\", value); }\r\n    function reject(value) { resume(\"throw\", value); }\r\n    function settle(f, v) { if (f(v), q.shift(), q.length) resume(q[0][0], q[0][1]); }\r\n}\r\n\r\nexport function __asyncDelegator(o) {\r\n    var i, p;\r\n    return i = {}, verb(\"next\"), verb(\"throw\", function (e) { throw e; }), verb(\"return\"), i[Symbol.iterator] = function () { return this; }, i;\r\n    function verb(n, f) { i[n] = o[n] ? function (v) { return (p = !p) ? { value: __await(o[n](v)), done: n === \"return\" } : f ? f(v) : v; } : f; }\r\n}\r\n\r\nexport function __asyncValues(o) {\r\n    if (!Symbol.asyncIterator) throw new TypeError(\"Symbol.asyncIterator is not defined.\");\r\n    var m = o[Symbol.asyncIterator], i;\r\n    return m ? m.call(o) : (o = typeof __values === \"function\" ? __values(o) : o[Symbol.iterator](), i = {}, verb(\"next\"), verb(\"throw\"), verb(\"return\"), i[Symbol.asyncIterator] = function () { return this; }, i);\r\n    function verb(n) { i[n] = o[n] && function (v) { return new Promise(function (resolve, reject) { v = o[n](v), settle(resolve, reject, v.done, v.value); }); }; }\r\n    function settle(resolve, reject, d, v) { Promise.resolve(v).then(function(v) { resolve({ value: v, done: d }); }, reject); }\r\n}\r\n\r\nexport function __makeTemplateObject(cooked, raw) {\r\n    if (Object.defineProperty) { Object.defineProperty(cooked, \"raw\", { value: raw }); } else { cooked.raw = raw; }\r\n    return cooked;\r\n};\r\n\r\nvar __setModuleDefault = Object.create ? (function(o, v) {\r\n    Object.defineProperty(o, \"default\", { enumerable: true, value: v });\r\n}) : function(o, v) {\r\n    o[\"default\"] = v;\r\n};\r\n\r\nexport function __importStar(mod) {\r\n    if (mod && mod.__esModule) return mod;\r\n    var result = {};\r\n    if (mod != null) for (var k in mod) if (k !== \"default\" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);\r\n    __setModuleDefault(result, mod);\r\n    return result;\r\n}\r\n\r\nexport function __importDefault(mod) {\r\n    return (mod && mod.__esModule) ? mod : { default: mod };\r\n}\r\n\r\nexport function __classPrivateFieldGet(receiver, state, kind, f) {\r\n    if (kind === \"a\" && !f) throw new TypeError(\"Private accessor was defined without a getter\");\r\n    if (typeof state === \"function\" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError(\"Cannot read private member from an object whose class did not declare it\");\r\n    return kind === \"m\" ? f : kind === \"a\" ? f.call(receiver) : f ? f.value : state.get(receiver);\r\n}\r\n\r\nexport function __classPrivateFieldSet(receiver, state, value, kind, f) {\r\n    if (kind === \"m\") throw new TypeError(\"Private method is not writable\");\r\n    if (kind === \"a\" && !f) throw new TypeError(\"Private accessor was defined without a setter\");\r\n    if (typeof state === \"function\" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError(\"Cannot write private member to an object whose class did not declare it\");\r\n    return (kind === \"a\" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;\r\n}\r\n","import { setImmediate as flushMicroTasks } from \"timers\";\n\nimport { JsPsych } from \"jspsych\";\n\nexport function dispatchEvent(event: Event) {\n  document.body.dispatchEvent(event);\n}\n\nexport function keyDown(key: string) {\n  dispatchEvent(new KeyboardEvent(\"keydown\", { key }));\n}\n\nexport function keyUp(key: string) {\n  dispatchEvent(new KeyboardEvent(\"keyup\", { key }));\n}\n\nexport function pressKey(key: string) {\n  keyDown(key);\n  keyUp(key);\n}\n\nexport function mouseDownMouseUpTarget(target: Element) {\n  target.dispatchEvent(new MouseEvent(\"mousedown\", { bubbles: true }));\n  target.dispatchEvent(new MouseEvent(\"mouseup\", { bubbles: true }));\n}\n\nexport function clickTarget(target: Element) {\n  target.dispatchEvent(new MouseEvent(\"click\", { bubbles: true }));\n}\n\n/**\n * Dispatch a `mousemove` event, with x and y defined relative to the container element.\n * @param x The x location of the event, relative to the x location of `container`.\n * @param y The y location of the event, relative to the y location of `container`.\n * @param container The DOM element for relative location of the event.\n */\nexport function mouseMove(x: number, y: number, container: Element) {\n  const containerRect = container.getBoundingClientRect();\n\n  const eventInit = {\n    clientX: containerRect.x + x,\n    clientY: containerRect.y + y,\n    bubbles: true,\n  };\n\n  container.dispatchEvent(new MouseEvent(\"mousemove\", eventInit));\n}\n\n/**\n * Dispatch a `mouseup` event, with x and y defined relative to the container element.\n * @param x The x location of the event, relative to the x location of `container`.\n * @param y The y location of the event, relative to the y location of `container`.\n * @param container The DOM element for relative location of the event.\n */\nexport function mouseUp(x: number, y: number, container: Element) {\n  const containerRect = container.getBoundingClientRect();\n\n  const eventInit = {\n    clientX: containerRect.x + x,\n    clientY: containerRect.y + y,\n    bubbles: true,\n  };\n\n  container.dispatchEvent(new MouseEvent(\"mouseup\", eventInit));\n}\n\n/**\n * Dispatch a `mousemove` event, with x and y defined relative to the container element.\n * @param x The x location of the event, relative to the x location of `container`.\n * @param y The y location of the event, relative to the y location of `container`.\n * @param container The DOM element for relative location of the event.\n */\nexport function mouseDown(x: number, y: number, container: Element) {\n  const containerRect = container.getBoundingClientRect();\n\n  const eventInit = {\n    clientX: containerRect.x + x,\n    clientY: containerRect.y + y,\n    bubbles: true,\n  };\n\n  container.dispatchEvent(new MouseEvent(\"mousedown\", eventInit));\n}\n\n/**\n * https://github.com/facebook/jest/issues/2157#issuecomment-279171856\n */\nexport function flushPromises() {\n  return new Promise((resolve) => flushMicroTasks(resolve));\n}\n\n/**\n * Runs the given timeline by calling `jsPsych.run()` on the provided JsPsych object.\n *\n * @param timeline The timeline that is passed to `jsPsych.run()`\n * @param jsPsych The jsPsych instance to be used. If left empty, a new instance will be created. If\n * a settings object is passed instead, the settings will be used to create the jsPsych instance.\n *\n * @returns An object containing test helper functions, the jsPsych instance, and the jsPsych\n * display element\n */\nexport async function startTimeline(timeline: any[], jsPsych: JsPsych | any = {}) {\n  const jsPsychInstance = jsPsych instanceof JsPsych ? jsPsych : new JsPsych(jsPsych);\n\n  let hasFinished = false;\n  const finished = jsPsychInstance.run(timeline).then(() => {\n    hasFinished = true;\n  });\n  await flushPromises();\n\n  const displayElement = jsPsychInstance.getDisplayElement();\n\n  return {\n    jsPsych: jsPsychInstance,\n    displayElement,\n    /** Shorthand for `jsPsych.getDisplayElement().innerHTML` */\n    getHTML: () => displayElement.innerHTML,\n    /** Shorthand for `jsPsych.data.get()` */\n    getData: () => jsPsychInstance.data.get(),\n    expectFinished: async () => {\n      await flushPromises();\n      expect(hasFinished).toBe(true);\n    },\n    expectRunning: async () => {\n      await flushPromises();\n      expect(hasFinished).toBe(false);\n    },\n    /** A promise that is resolved when `jsPsych.run()` is done. */\n    finished,\n  };\n}\n\n/**\n * Runs the given timeline by calling `jsPsych.simulate()` on the provided JsPsych object.\n *\n * @param timeline The timeline that is passed to `jsPsych.run()`\n * @param simulation_mode Either 'data-only' mode or 'visual' mode.\n * @param simulation_options Options to pass to `jsPsych.simulate()`\n * @param jsPsych The jsPsych instance to be used. If left empty, a new instance will be created. If\n * a settings object is passed instead, the settings will be used to create the jsPsych instance.\n *\n * @returns An object containing test helper functions, the jsPsych instance, and the jsPsych\n * display element\n */\nexport async function simulateTimeline(\n  timeline: any[],\n  simulation_mode: \"data-only\" | \"visual\" = \"data-only\",\n  simulation_options: any = {},\n  jsPsych: JsPsych | any = {}\n) {\n  const jsPsychInstance = jsPsych instanceof JsPsych ? jsPsych : new JsPsych(jsPsych);\n\n  let hasFinished = false;\n  const finished = jsPsychInstance\n    .simulate(timeline, simulation_mode, simulation_options)\n    .then(() => {\n      hasFinished = true;\n    });\n  await flushPromises();\n\n  const displayElement = jsPsychInstance.getDisplayElement();\n\n  return {\n    jsPsych: jsPsychInstance,\n    displayElement,\n    /** Shorthand for `jsPsych.getDisplayElement().innerHTML` */\n    getHTML: () => displayElement.innerHTML,\n    /** Shorthand for `jsPsych.data.get()` */\n    getData: () => jsPsychInstance.data.get(),\n    expectFinished: async () => {\n      await flushPromises();\n      expect(hasFinished).toBe(true);\n    },\n    expectRunning: async () => {\n      await flushPromises();\n      expect(hasFinished).toBe(false);\n    },\n    /** A promise that is resolved when `jsPsych.simulate()` is done. */\n    finished,\n  };\n}\n"],"names":["flushMicroTasks","JsPsych"],"mappings":"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"}

package/dist/index.d.ts

@@ -5,6 +5,27 @@ export declare function keyUp(key: string): void;
 export declare function pressKey(key: string): void;
 export declare function mouseDownMouseUpTarget(target: Element): void;
 export declare function clickTarget(target: Element): void;
+/**
+ * Dispatch a `mousemove` event, with x and y defined relative to the container element.
+ * @param x The x location of the event, relative to the x location of `container`.
+ * @param y The y location of the event, relative to the y location of `container`.
+ * @param container The DOM element for relative location of the event.
+ */
+export declare function mouseMove(x: number, y: number, container: Element): void;
+/**
+ * Dispatch a `mouseup` event, with x and y defined relative to the container element.
+ * @param x The x location of the event, relative to the x location of `container`.
+ * @param y The y location of the event, relative to the y location of `container`.
+ * @param container The DOM element for relative location of the event.
+ */
+export declare function mouseUp(x: number, y: number, container: Element): void;
+/**
+ * Dispatch a `mousemove` event, with x and y defined relative to the container element.
+ * @param x The x location of the event, relative to the x location of `container`.
+ * @param y The y location of the event, relative to the y location of `container`.
+ * @param container The DOM element for relative location of the event.
+ */
+export declare function mouseDown(x: number, y: number, container: Element): void;
 /**
  * https://github.com/facebook/jest/issues/2157#issuecomment-279171856
  */
@@ -31,3 +52,27 @@ export declare function startTimeline(timeline: any[], jsPsych?: JsPsych | any):
     /** A promise that is resolved when `jsPsych.run()` is done. */
     finished: Promise<void>;
 }>;
+/**
+ * Runs the given timeline by calling `jsPsych.simulate()` on the provided JsPsych object.
+ *
+ * @param timeline The timeline that is passed to `jsPsych.run()`
+ * @param simulation_mode Either 'data-only' mode or 'visual' mode.
+ * @param simulation_options Options to pass to `jsPsych.simulate()`
+ * @param jsPsych The jsPsych instance to be used. If left empty, a new instance will be created. If
+ * a settings object is passed instead, the settings will be used to create the jsPsych instance.
+ *
+ * @returns An object containing test helper functions, the jsPsych instance, and the jsPsych
+ * display element
+ */
+export declare function simulateTimeline(timeline: any[], simulation_mode?: "data-only" | "visual", simulation_options?: any, jsPsych?: JsPsych | any): Promise<{
+    jsPsych: JsPsych;
+    displayElement: HTMLElement;
+    /** Shorthand for `jsPsych.getDisplayElement().innerHTML` */
+    getHTML: () => string;
+    /** Shorthand for `jsPsych.data.get()` */
+    getData: () => import("jspsych/dist/modules/data/DataCollection").DataCollection;
+    expectFinished: () => Promise<void>;
+    expectRunning: () => Promise<void>;
+    /** A promise that is resolved when `jsPsych.simulate()` is done. */
+    finished: Promise<void>;
+}>;

package/dist/index.js

@@ -46,6 +46,51 @@ function mouseDownMouseUpTarget(target) {
 function clickTarget(target) {
     target.dispatchEvent(new MouseEvent("click", { bubbles: true }));
 }
+/**
+ * Dispatch a `mousemove` event, with x and y defined relative to the container element.
+ * @param x The x location of the event, relative to the x location of `container`.
+ * @param y The y location of the event, relative to the y location of `container`.
+ * @param container The DOM element for relative location of the event.
+ */
+function mouseMove(x, y, container) {
+    const containerRect = container.getBoundingClientRect();
+    const eventInit = {
+        clientX: containerRect.x + x,
+        clientY: containerRect.y + y,
+        bubbles: true,
+    };
+    container.dispatchEvent(new MouseEvent("mousemove", eventInit));
+}
+/**
+ * Dispatch a `mouseup` event, with x and y defined relative to the container element.
+ * @param x The x location of the event, relative to the x location of `container`.
+ * @param y The y location of the event, relative to the y location of `container`.
+ * @param container The DOM element for relative location of the event.
+ */
+function mouseUp(x, y, container) {
+    const containerRect = container.getBoundingClientRect();
+    const eventInit = {
+        clientX: containerRect.x + x,
+        clientY: containerRect.y + y,
+        bubbles: true,
+    };
+    container.dispatchEvent(new MouseEvent("mouseup", eventInit));
+}
+/**
+ * Dispatch a `mousemove` event, with x and y defined relative to the container element.
+ * @param x The x location of the event, relative to the x location of `container`.
+ * @param y The y location of the event, relative to the y location of `container`.
+ * @param container The DOM element for relative location of the event.
+ */
+function mouseDown(x, y, container) {
+    const containerRect = container.getBoundingClientRect();
+    const eventInit = {
+        clientX: containerRect.x + x,
+        clientY: containerRect.y + y,
+        bubbles: true,
+    };
+    container.dispatchEvent(new MouseEvent("mousedown", eventInit));
+}
 /**
  * https://github.com/facebook/jest/issues/2157#issuecomment-279171856
  */
@@ -90,7 +135,50 @@ function startTimeline(timeline, jsPsych = {}) {
             finished,
         };
     });
+}
+/**
+ * Runs the given timeline by calling `jsPsych.simulate()` on the provided JsPsych object.
+ *
+ * @param timeline The timeline that is passed to `jsPsych.run()`
+ * @param simulation_mode Either 'data-only' mode or 'visual' mode.
+ * @param simulation_options Options to pass to `jsPsych.simulate()`
+ * @param jsPsych The jsPsych instance to be used. If left empty, a new instance will be created. If
+ * a settings object is passed instead, the settings will be used to create the jsPsych instance.
+ *
+ * @returns An object containing test helper functions, the jsPsych instance, and the jsPsych
+ * display element
+ */
+function simulateTimeline(timeline, simulation_mode = "data-only", simulation_options = {}, jsPsych = {}) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const jsPsychInstance = jsPsych instanceof JsPsych ? jsPsych : new JsPsych(jsPsych);
+        let hasFinished = false;
+        const finished = jsPsychInstance
+            .simulate(timeline, simulation_mode, simulation_options)
+            .then(() => {
+            hasFinished = true;
+        });
+        yield flushPromises();
+        const displayElement = jsPsychInstance.getDisplayElement();
+        return {
+            jsPsych: jsPsychInstance,
+            displayElement,
+            /** Shorthand for `jsPsych.getDisplayElement().innerHTML` */
+            getHTML: () => displayElement.innerHTML,
+            /** Shorthand for `jsPsych.data.get()` */
+            getData: () => jsPsychInstance.data.get(),
+            expectFinished: () => __awaiter(this, void 0, void 0, function* () {
+                yield flushPromises();
+                expect(hasFinished).toBe(true);
+            }),
+            expectRunning: () => __awaiter(this, void 0, void 0, function* () {
+                yield flushPromises();
+                expect(hasFinished).toBe(false);
+            }),
+            /** A promise that is resolved when `jsPsych.simulate()` is done. */
+            finished,
+        };
+    });
 }
 
-export { clickTarget, dispatchEvent, flushPromises, keyDown, keyUp, mouseDownMouseUpTarget, pressKey, startTimeline };
+export { clickTarget, dispatchEvent, flushPromises, keyDown, keyUp, mouseDown, mouseDownMouseUpTarget, mouseMove, mouseUp, pressKey, simulateTimeline, startTimeline };
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":["../../../node_modules/tslib/tslib.es6.js","../src/index.ts"],"sourcesContent":["/*! *****************************************************************************\r\nCopyright (c) Microsoft Corporation.\r\n\r\nPermission to use, copy, modify, and/or distribute this software for any\r\npurpose with or without fee is hereby granted.\r\n\r\nTHE SOFTWARE IS PROVIDED \"AS IS\" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH\r\nREGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY\r\nAND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT,\r\nINDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM\r\nLOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR\r\nOTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR\r\nPERFORMANCE OF THIS SOFTWARE.\r\n***************************************************************************** */\r\n/* global Reflect, Promise */\r\n\r\nvar extendStatics = function(d, b) {\r\n    extendStatics = Object.setPrototypeOf ||\r\n        ({ __proto__: [] } instanceof Array && function (d, b) { d.__proto__ = b; }) ||\r\n        function (d, b) { for (var p in b) if (Object.prototype.hasOwnProperty.call(b, p)) d[p] = b[p]; };\r\n    return extendStatics(d, b);\r\n};\r\n\r\nexport function __extends(d, b) {\r\n    if (typeof b !== \"function\" && b !== null)\r\n        throw new TypeError(\"Class extends value \" + String(b) + \" is not a constructor or null\");\r\n    extendStatics(d, b);\r\n    function __() { this.constructor = d; }\r\n    d.prototype = b === null ? Object.create(b) : (__.prototype = b.prototype, new __());\r\n}\r\n\r\nexport var __assign = function() {\r\n    __assign = Object.assign || function __assign(t) {\r\n        for (var s, i = 1, n = arguments.length; i < n; i++) {\r\n            s = arguments[i];\r\n            for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p)) t[p] = s[p];\r\n        }\r\n        return t;\r\n    }\r\n    return __assign.apply(this, arguments);\r\n}\r\n\r\nexport function __rest(s, e) {\r\n    var t = {};\r\n    for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p) && e.indexOf(p) < 0)\r\n        t[p] = s[p];\r\n    if (s != null && typeof Object.getOwnPropertySymbols === \"function\")\r\n        for (var i = 0, p = Object.getOwnPropertySymbols(s); i < p.length; i++) {\r\n            if (e.indexOf(p[i]) < 0 && Object.prototype.propertyIsEnumerable.call(s, p[i]))\r\n                t[p[i]] = s[p[i]];\r\n        }\r\n    return t;\r\n}\r\n\r\nexport function __decorate(decorators, target, key, desc) {\r\n    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;\r\n    if (typeof Reflect === \"object\" && typeof Reflect.decorate === \"function\") r = Reflect.decorate(decorators, target, key, desc);\r\n    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;\r\n    return c > 3 && r && Object.defineProperty(target, key, r), r;\r\n}\r\n\r\nexport function __param(paramIndex, decorator) {\r\n    return function (target, key) { decorator(target, key, paramIndex); }\r\n}\r\n\r\nexport function __metadata(metadataKey, metadataValue) {\r\n    if (typeof Reflect === \"object\" && typeof Reflect.metadata === \"function\") return Reflect.metadata(metadataKey, metadataValue);\r\n}\r\n\r\nexport function __awaiter(thisArg, _arguments, P, generator) {\r\n    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }\r\n    return new (P || (P = Promise))(function (resolve, reject) {\r\n        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }\r\n        function rejected(value) { try { step(generator[\"throw\"](value)); } catch (e) { reject(e); } }\r\n        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }\r\n        step((generator = generator.apply(thisArg, _arguments || [])).next());\r\n    });\r\n}\r\n\r\nexport function __generator(thisArg, body) {\r\n    var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g;\r\n    return g = { next: verb(0), \"throw\": verb(1), \"return\": verb(2) }, typeof Symbol === \"function\" && (g[Symbol.iterator] = function() { return this; }), g;\r\n    function verb(n) { return function (v) { return step([n, v]); }; }\r\n    function step(op) {\r\n        if (f) throw new TypeError(\"Generator is already executing.\");\r\n        while (_) try {\r\n            if (f = 1, y && (t = op[0] & 2 ? y[\"return\"] : op[0] ? y[\"throw\"] || ((t = y[\"return\"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;\r\n            if (y = 0, t) op = [op[0] & 2, t.value];\r\n            switch (op[0]) {\r\n                case 0: case 1: t = op; break;\r\n                case 4: _.label++; return { value: op[1], done: false };\r\n                case 5: _.label++; y = op[1]; op = [0]; continue;\r\n                case 7: op = _.ops.pop(); _.trys.pop(); continue;\r\n                default:\r\n                    if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }\r\n                    if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }\r\n                    if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }\r\n                    if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }\r\n                    if (t[2]) _.ops.pop();\r\n                    _.trys.pop(); continue;\r\n            }\r\n            op = body.call(thisArg, _);\r\n        } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }\r\n        if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };\r\n    }\r\n}\r\n\r\nexport var __createBinding = Object.create ? (function(o, m, k, k2) {\r\n    if (k2 === undefined) k2 = k;\r\n    Object.defineProperty(o, k2, { enumerable: true, get: function() { return m[k]; } });\r\n}) : (function(o, m, k, k2) {\r\n    if (k2 === undefined) k2 = k;\r\n    o[k2] = m[k];\r\n});\r\n\r\nexport function __exportStar(m, o) {\r\n    for (var p in m) if (p !== \"default\" && !Object.prototype.hasOwnProperty.call(o, p)) __createBinding(o, m, p);\r\n}\r\n\r\nexport function __values(o) {\r\n    var s = typeof Symbol === \"function\" && Symbol.iterator, m = s && o[s], i = 0;\r\n    if (m) return m.call(o);\r\n    if (o && typeof o.length === \"number\") return {\r\n        next: function () {\r\n            if (o && i >= o.length) o = void 0;\r\n            return { value: o && o[i++], done: !o };\r\n        }\r\n    };\r\n    throw new TypeError(s ? \"Object is not iterable.\" : \"Symbol.iterator is not defined.\");\r\n}\r\n\r\nexport function __read(o, n) {\r\n    var m = typeof Symbol === \"function\" && o[Symbol.iterator];\r\n    if (!m) return o;\r\n    var i = m.call(o), r, ar = [], e;\r\n    try {\r\n        while ((n === void 0 || n-- > 0) && !(r = i.next()).done) ar.push(r.value);\r\n    }\r\n    catch (error) { e = { error: error }; }\r\n    finally {\r\n        try {\r\n            if (r && !r.done && (m = i[\"return\"])) m.call(i);\r\n        }\r\n        finally { if (e) throw e.error; }\r\n    }\r\n    return ar;\r\n}\r\n\r\n/** @deprecated */\r\nexport function __spread() {\r\n    for (var ar = [], i = 0; i < arguments.length; i++)\r\n        ar = ar.concat(__read(arguments[i]));\r\n    return ar;\r\n}\r\n\r\n/** @deprecated */\r\nexport function __spreadArrays() {\r\n    for (var s = 0, i = 0, il = arguments.length; i < il; i++) s += arguments[i].length;\r\n    for (var r = Array(s), k = 0, i = 0; i < il; i++)\r\n        for (var a = arguments[i], j = 0, jl = a.length; j < jl; j++, k++)\r\n            r[k] = a[j];\r\n    return r;\r\n}\r\n\r\nexport function __spreadArray(to, from, pack) {\r\n    if (pack || arguments.length === 2) for (var i = 0, l = from.length, ar; i < l; i++) {\r\n        if (ar || !(i in from)) {\r\n            if (!ar) ar = Array.prototype.slice.call(from, 0, i);\r\n            ar[i] = from[i];\r\n        }\r\n    }\r\n    return to.concat(ar || Array.prototype.slice.call(from));\r\n}\r\n\r\nexport function __await(v) {\r\n    return this instanceof __await ? (this.v = v, this) : new __await(v);\r\n}\r\n\r\nexport function __asyncGenerator(thisArg, _arguments, generator) {\r\n    if (!Symbol.asyncIterator) throw new TypeError(\"Symbol.asyncIterator is not defined.\");\r\n    var g = generator.apply(thisArg, _arguments || []), i, q = [];\r\n    return i = {}, verb(\"next\"), verb(\"throw\"), verb(\"return\"), i[Symbol.asyncIterator] = function () { return this; }, i;\r\n    function verb(n) { if (g[n]) i[n] = function (v) { return new Promise(function (a, b) { q.push([n, v, a, b]) > 1 || resume(n, v); }); }; }\r\n    function resume(n, v) { try { step(g[n](v)); } catch (e) { settle(q[0][3], e); } }\r\n    function step(r) { r.value instanceof __await ? Promise.resolve(r.value.v).then(fulfill, reject) : settle(q[0][2], r); }\r\n    function fulfill(value) { resume(\"next\", value); }\r\n    function reject(value) { resume(\"throw\", value); }\r\n    function settle(f, v) { if (f(v), q.shift(), q.length) resume(q[0][0], q[0][1]); }\r\n}\r\n\r\nexport function __asyncDelegator(o) {\r\n    var i, p;\r\n    return i = {}, verb(\"next\"), verb(\"throw\", function (e) { throw e; }), verb(\"return\"), i[Symbol.iterator] = function () { return this; }, i;\r\n    function verb(n, f) { i[n] = o[n] ? function (v) { return (p = !p) ? { value: __await(o[n](v)), done: n === \"return\" } : f ? f(v) : v; } : f; }\r\n}\r\n\r\nexport function __asyncValues(o) {\r\n    if (!Symbol.asyncIterator) throw new TypeError(\"Symbol.asyncIterator is not defined.\");\r\n    var m = o[Symbol.asyncIterator], i;\r\n    return m ? m.call(o) : (o = typeof __values === \"function\" ? __values(o) : o[Symbol.iterator](), i = {}, verb(\"next\"), verb(\"throw\"), verb(\"return\"), i[Symbol.asyncIterator] = function () { return this; }, i);\r\n    function verb(n) { i[n] = o[n] && function (v) { return new Promise(function (resolve, reject) { v = o[n](v), settle(resolve, reject, v.done, v.value); }); }; }\r\n    function settle(resolve, reject, d, v) { Promise.resolve(v).then(function(v) { resolve({ value: v, done: d }); }, reject); }\r\n}\r\n\r\nexport function __makeTemplateObject(cooked, raw) {\r\n    if (Object.defineProperty) { Object.defineProperty(cooked, \"raw\", { value: raw }); } else { cooked.raw = raw; }\r\n    return cooked;\r\n};\r\n\r\nvar __setModuleDefault = Object.create ? (function(o, v) {\r\n    Object.defineProperty(o, \"default\", { enumerable: true, value: v });\r\n}) : function(o, v) {\r\n    o[\"default\"] = v;\r\n};\r\n\r\nexport function __importStar(mod) {\r\n    if (mod && mod.__esModule) return mod;\r\n    var result = {};\r\n    if (mod != null) for (var k in mod) if (k !== \"default\" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);\r\n    __setModuleDefault(result, mod);\r\n    return result;\r\n}\r\n\r\nexport function __importDefault(mod) {\r\n    return (mod && mod.__esModule) ? mod : { default: mod };\r\n}\r\n\r\nexport function __classPrivateFieldGet(receiver, state, kind, f) {\r\n    if (kind === \"a\" && !f) throw new TypeError(\"Private accessor was defined without a getter\");\r\n    if (typeof state === \"function\" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError(\"Cannot read private member from an object whose class did not declare it\");\r\n    return kind === \"m\" ? f : kind === \"a\" ? f.call(receiver) : f ? f.value : state.get(receiver);\r\n}\r\n\r\nexport function __classPrivateFieldSet(receiver, state, value, kind, f) {\r\n    if (kind === \"m\") throw new TypeError(\"Private method is not writable\");\r\n    if (kind === \"a\" && !f) throw new TypeError(\"Private accessor was defined without a setter\");\r\n    if (typeof state === \"function\" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError(\"Cannot write private member to an object whose class did not declare it\");\r\n    return (kind === \"a\" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;\r\n}\r\n","import { setImmediate as flushMicroTasks } from \"timers\";\n\nimport { JsPsych } from \"jspsych\";\n\nexport function dispatchEvent(event: Event) {\n  document.body.dispatchEvent(event);\n}\n\nexport function keyDown(key: string) {\n  dispatchEvent(new KeyboardEvent(\"keydown\", { key }));\n}\n\nexport function keyUp(key: string) {\n  dispatchEvent(new KeyboardEvent(\"keyup\", { key }));\n}\n\nexport function pressKey(key: string) {\n  keyDown(key);\n  keyUp(key);\n}\n\nexport function mouseDownMouseUpTarget(target: Element) {\n  target.dispatchEvent(new MouseEvent(\"mousedown\", { bubbles: true }));\n  target.dispatchEvent(new MouseEvent(\"mouseup\", { bubbles: true }));\n}\n\nexport function clickTarget(target: Element) {\n  target.dispatchEvent(new MouseEvent(\"click\", { bubbles: true }));\n}\n\n/**\n * https://github.com/facebook/jest/issues/2157#issuecomment-279171856\n */\nexport function flushPromises() {\n  return new Promise((resolve) => flushMicroTasks(resolve));\n}\n\n/**\n * Runs the given timeline by calling `jsPsych.run()` on the provided JsPsych object.\n *\n * @param timeline The timeline that is passed to `jsPsych.run()`\n * @param jsPsych The jsPsych instance to be used. If left empty, a new instance will be created. If\n * a settings object is passed instead, the settings will be used to create the jsPsych instance.\n *\n * @returns An object containing test helper functions, the jsPsych instance, and the jsPsych\n * display element\n */\nexport async function startTimeline(timeline: any[], jsPsych: JsPsych | any = {}) {\n  const jsPsychInstance = jsPsych instanceof JsPsych ? jsPsych : new JsPsych(jsPsych);\n\n  let hasFinished = false;\n  const finished = jsPsychInstance.run(timeline).then(() => {\n    hasFinished = true;\n  });\n  await flushPromises();\n\n  const displayElement = jsPsychInstance.getDisplayElement();\n\n  return {\n    jsPsych: jsPsychInstance,\n    displayElement,\n    /** Shorthand for `jsPsych.getDisplayElement().innerHTML` */\n    getHTML: () => displayElement.innerHTML,\n    /** Shorthand for `jsPsych.data.get()` */\n    getData: () => jsPsychInstance.data.get(),\n    expectFinished: async () => {\n      await flushPromises();\n      expect(hasFinished).toBe(true);\n    },\n    expectRunning: async () => {\n      await flushPromises();\n      expect(hasFinished).toBe(false);\n    },\n    /** A promise that is resolved when `jsPsych.run()` is done. */\n    finished,\n  };\n}\n"],"names":["flushMicroTasks"],"mappings":"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"}
+{"version":3,"file":"index.js","sources":["../../../node_modules/tslib/tslib.es6.js","../src/index.ts"],"sourcesContent":["/*! *****************************************************************************\r\nCopyright (c) Microsoft Corporation.\r\n\r\nPermission to use, copy, modify, and/or distribute this software for any\r\npurpose with or without fee is hereby granted.\r\n\r\nTHE SOFTWARE IS PROVIDED \"AS IS\" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH\r\nREGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY\r\nAND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT,\r\nINDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM\r\nLOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR\r\nOTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR\r\nPERFORMANCE OF THIS SOFTWARE.\r\n***************************************************************************** */\r\n/* global Reflect, Promise */\r\n\r\nvar extendStatics = function(d, b) {\r\n    extendStatics = Object.setPrototypeOf ||\r\n        ({ __proto__: [] } instanceof Array && function (d, b) { d.__proto__ = b; }) ||\r\n        function (d, b) { for (var p in b) if (Object.prototype.hasOwnProperty.call(b, p)) d[p] = b[p]; };\r\n    return extendStatics(d, b);\r\n};\r\n\r\nexport function __extends(d, b) {\r\n    if (typeof b !== \"function\" && b !== null)\r\n        throw new TypeError(\"Class extends value \" + String(b) + \" is not a constructor or null\");\r\n    extendStatics(d, b);\r\n    function __() { this.constructor = d; }\r\n    d.prototype = b === null ? Object.create(b) : (__.prototype = b.prototype, new __());\r\n}\r\n\r\nexport var __assign = function() {\r\n    __assign = Object.assign || function __assign(t) {\r\n        for (var s, i = 1, n = arguments.length; i < n; i++) {\r\n            s = arguments[i];\r\n            for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p)) t[p] = s[p];\r\n        }\r\n        return t;\r\n    }\r\n    return __assign.apply(this, arguments);\r\n}\r\n\r\nexport function __rest(s, e) {\r\n    var t = {};\r\n    for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p) && e.indexOf(p) < 0)\r\n        t[p] = s[p];\r\n    if (s != null && typeof Object.getOwnPropertySymbols === \"function\")\r\n        for (var i = 0, p = Object.getOwnPropertySymbols(s); i < p.length; i++) {\r\n            if (e.indexOf(p[i]) < 0 && Object.prototype.propertyIsEnumerable.call(s, p[i]))\r\n                t[p[i]] = s[p[i]];\r\n        }\r\n    return t;\r\n}\r\n\r\nexport function __decorate(decorators, target, key, desc) {\r\n    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;\r\n    if (typeof Reflect === \"object\" && typeof Reflect.decorate === \"function\") r = Reflect.decorate(decorators, target, key, desc);\r\n    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;\r\n    return c > 3 && r && Object.defineProperty(target, key, r), r;\r\n}\r\n\r\nexport function __param(paramIndex, decorator) {\r\n    return function (target, key) { decorator(target, key, paramIndex); }\r\n}\r\n\r\nexport function __metadata(metadataKey, metadataValue) {\r\n    if (typeof Reflect === \"object\" && typeof Reflect.metadata === \"function\") return Reflect.metadata(metadataKey, metadataValue);\r\n}\r\n\r\nexport function __awaiter(thisArg, _arguments, P, generator) {\r\n    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }\r\n    return new (P || (P = Promise))(function (resolve, reject) {\r\n        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }\r\n        function rejected(value) { try { step(generator[\"throw\"](value)); } catch (e) { reject(e); } }\r\n        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }\r\n        step((generator = generator.apply(thisArg, _arguments || [])).next());\r\n    });\r\n}\r\n\r\nexport function __generator(thisArg, body) {\r\n    var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g;\r\n    return g = { next: verb(0), \"throw\": verb(1), \"return\": verb(2) }, typeof Symbol === \"function\" && (g[Symbol.iterator] = function() { return this; }), g;\r\n    function verb(n) { return function (v) { return step([n, v]); }; }\r\n    function step(op) {\r\n        if (f) throw new TypeError(\"Generator is already executing.\");\r\n        while (_) try {\r\n            if (f = 1, y && (t = op[0] & 2 ? y[\"return\"] : op[0] ? y[\"throw\"] || ((t = y[\"return\"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;\r\n            if (y = 0, t) op = [op[0] & 2, t.value];\r\n            switch (op[0]) {\r\n                case 0: case 1: t = op; break;\r\n                case 4: _.label++; return { value: op[1], done: false };\r\n                case 5: _.label++; y = op[1]; op = [0]; continue;\r\n                case 7: op = _.ops.pop(); _.trys.pop(); continue;\r\n                default:\r\n                    if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }\r\n                    if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }\r\n                    if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }\r\n                    if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }\r\n                    if (t[2]) _.ops.pop();\r\n                    _.trys.pop(); continue;\r\n            }\r\n            op = body.call(thisArg, _);\r\n        } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }\r\n        if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };\r\n    }\r\n}\r\n\r\nexport var __createBinding = Object.create ? (function(o, m, k, k2) {\r\n    if (k2 === undefined) k2 = k;\r\n    Object.defineProperty(o, k2, { enumerable: true, get: function() { return m[k]; } });\r\n}) : (function(o, m, k, k2) {\r\n    if (k2 === undefined) k2 = k;\r\n    o[k2] = m[k];\r\n});\r\n\r\nexport function __exportStar(m, o) {\r\n    for (var p in m) if (p !== \"default\" && !Object.prototype.hasOwnProperty.call(o, p)) __createBinding(o, m, p);\r\n}\r\n\r\nexport function __values(o) {\r\n    var s = typeof Symbol === \"function\" && Symbol.iterator, m = s && o[s], i = 0;\r\n    if (m) return m.call(o);\r\n    if (o && typeof o.length === \"number\") return {\r\n        next: function () {\r\n            if (o && i >= o.length) o = void 0;\r\n            return { value: o && o[i++], done: !o };\r\n        }\r\n    };\r\n    throw new TypeError(s ? \"Object is not iterable.\" : \"Symbol.iterator is not defined.\");\r\n}\r\n\r\nexport function __read(o, n) {\r\n    var m = typeof Symbol === \"function\" && o[Symbol.iterator];\r\n    if (!m) return o;\r\n    var i = m.call(o), r, ar = [], e;\r\n    try {\r\n        while ((n === void 0 || n-- > 0) && !(r = i.next()).done) ar.push(r.value);\r\n    }\r\n    catch (error) { e = { error: error }; }\r\n    finally {\r\n        try {\r\n            if (r && !r.done && (m = i[\"return\"])) m.call(i);\r\n        }\r\n        finally { if (e) throw e.error; }\r\n    }\r\n    return ar;\r\n}\r\n\r\n/** @deprecated */\r\nexport function __spread() {\r\n    for (var ar = [], i = 0; i < arguments.length; i++)\r\n        ar = ar.concat(__read(arguments[i]));\r\n    return ar;\r\n}\r\n\r\n/** @deprecated */\r\nexport function __spreadArrays() {\r\n    for (var s = 0, i = 0, il = arguments.length; i < il; i++) s += arguments[i].length;\r\n    for (var r = Array(s), k = 0, i = 0; i < il; i++)\r\n        for (var a = arguments[i], j = 0, jl = a.length; j < jl; j++, k++)\r\n            r[k] = a[j];\r\n    return r;\r\n}\r\n\r\nexport function __spreadArray(to, from, pack) {\r\n    if (pack || arguments.length === 2) for (var i = 0, l = from.length, ar; i < l; i++) {\r\n        if (ar || !(i in from)) {\r\n            if (!ar) ar = Array.prototype.slice.call(from, 0, i);\r\n            ar[i] = from[i];\r\n        }\r\n    }\r\n    return to.concat(ar || Array.prototype.slice.call(from));\r\n}\r\n\r\nexport function __await(v) {\r\n    return this instanceof __await ? (this.v = v, this) : new __await(v);\r\n}\r\n\r\nexport function __asyncGenerator(thisArg, _arguments, generator) {\r\n    if (!Symbol.asyncIterator) throw new TypeError(\"Symbol.asyncIterator is not defined.\");\r\n    var g = generator.apply(thisArg, _arguments || []), i, q = [];\r\n    return i = {}, verb(\"next\"), verb(\"throw\"), verb(\"return\"), i[Symbol.asyncIterator] = function () { return this; }, i;\r\n    function verb(n) { if (g[n]) i[n] = function (v) { return new Promise(function (a, b) { q.push([n, v, a, b]) > 1 || resume(n, v); }); }; }\r\n    function resume(n, v) { try { step(g[n](v)); } catch (e) { settle(q[0][3], e); } }\r\n    function step(r) { r.value instanceof __await ? Promise.resolve(r.value.v).then(fulfill, reject) : settle(q[0][2], r); }\r\n    function fulfill(value) { resume(\"next\", value); }\r\n    function reject(value) { resume(\"throw\", value); }\r\n    function settle(f, v) { if (f(v), q.shift(), q.length) resume(q[0][0], q[0][1]); }\r\n}\r\n\r\nexport function __asyncDelegator(o) {\r\n    var i, p;\r\n    return i = {}, verb(\"next\"), verb(\"throw\", function (e) { throw e; }), verb(\"return\"), i[Symbol.iterator] = function () { return this; }, i;\r\n    function verb(n, f) { i[n] = o[n] ? function (v) { return (p = !p) ? { value: __await(o[n](v)), done: n === \"return\" } : f ? f(v) : v; } : f; }\r\n}\r\n\r\nexport function __asyncValues(o) {\r\n    if (!Symbol.asyncIterator) throw new TypeError(\"Symbol.asyncIterator is not defined.\");\r\n    var m = o[Symbol.asyncIterator], i;\r\n    return m ? m.call(o) : (o = typeof __values === \"function\" ? __values(o) : o[Symbol.iterator](), i = {}, verb(\"next\"), verb(\"throw\"), verb(\"return\"), i[Symbol.asyncIterator] = function () { return this; }, i);\r\n    function verb(n) { i[n] = o[n] && function (v) { return new Promise(function (resolve, reject) { v = o[n](v), settle(resolve, reject, v.done, v.value); }); }; }\r\n    function settle(resolve, reject, d, v) { Promise.resolve(v).then(function(v) { resolve({ value: v, done: d }); }, reject); }\r\n}\r\n\r\nexport function __makeTemplateObject(cooked, raw) {\r\n    if (Object.defineProperty) { Object.defineProperty(cooked, \"raw\", { value: raw }); } else { cooked.raw = raw; }\r\n    return cooked;\r\n};\r\n\r\nvar __setModuleDefault = Object.create ? (function(o, v) {\r\n    Object.defineProperty(o, \"default\", { enumerable: true, value: v });\r\n}) : function(o, v) {\r\n    o[\"default\"] = v;\r\n};\r\n\r\nexport function __importStar(mod) {\r\n    if (mod && mod.__esModule) return mod;\r\n    var result = {};\r\n    if (mod != null) for (var k in mod) if (k !== \"default\" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);\r\n    __setModuleDefault(result, mod);\r\n    return result;\r\n}\r\n\r\nexport function __importDefault(mod) {\r\n    return (mod && mod.__esModule) ? mod : { default: mod };\r\n}\r\n\r\nexport function __classPrivateFieldGet(receiver, state, kind, f) {\r\n    if (kind === \"a\" && !f) throw new TypeError(\"Private accessor was defined without a getter\");\r\n    if (typeof state === \"function\" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError(\"Cannot read private member from an object whose class did not declare it\");\r\n    return kind === \"m\" ? f : kind === \"a\" ? f.call(receiver) : f ? f.value : state.get(receiver);\r\n}\r\n\r\nexport function __classPrivateFieldSet(receiver, state, value, kind, f) {\r\n    if (kind === \"m\") throw new TypeError(\"Private method is not writable\");\r\n    if (kind === \"a\" && !f) throw new TypeError(\"Private accessor was defined without a setter\");\r\n    if (typeof state === \"function\" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError(\"Cannot write private member to an object whose class did not declare it\");\r\n    return (kind === \"a\" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;\r\n}\r\n","import { setImmediate as flushMicroTasks } from \"timers\";\n\nimport { JsPsych } from \"jspsych\";\n\nexport function dispatchEvent(event: Event) {\n  document.body.dispatchEvent(event);\n}\n\nexport function keyDown(key: string) {\n  dispatchEvent(new KeyboardEvent(\"keydown\", { key }));\n}\n\nexport function keyUp(key: string) {\n  dispatchEvent(new KeyboardEvent(\"keyup\", { key }));\n}\n\nexport function pressKey(key: string) {\n  keyDown(key);\n  keyUp(key);\n}\n\nexport function mouseDownMouseUpTarget(target: Element) {\n  target.dispatchEvent(new MouseEvent(\"mousedown\", { bubbles: true }));\n  target.dispatchEvent(new MouseEvent(\"mouseup\", { bubbles: true }));\n}\n\nexport function clickTarget(target: Element) {\n  target.dispatchEvent(new MouseEvent(\"click\", { bubbles: true }));\n}\n\n/**\n * Dispatch a `mousemove` event, with x and y defined relative to the container element.\n * @param x The x location of the event, relative to the x location of `container`.\n * @param y The y location of the event, relative to the y location of `container`.\n * @param container The DOM element for relative location of the event.\n */\nexport function mouseMove(x: number, y: number, container: Element) {\n  const containerRect = container.getBoundingClientRect();\n\n  const eventInit = {\n    clientX: containerRect.x + x,\n    clientY: containerRect.y + y,\n    bubbles: true,\n  };\n\n  container.dispatchEvent(new MouseEvent(\"mousemove\", eventInit));\n}\n\n/**\n * Dispatch a `mouseup` event, with x and y defined relative to the container element.\n * @param x The x location of the event, relative to the x location of `container`.\n * @param y The y location of the event, relative to the y location of `container`.\n * @param container The DOM element for relative location of the event.\n */\nexport function mouseUp(x: number, y: number, container: Element) {\n  const containerRect = container.getBoundingClientRect();\n\n  const eventInit = {\n    clientX: containerRect.x + x,\n    clientY: containerRect.y + y,\n    bubbles: true,\n  };\n\n  container.dispatchEvent(new MouseEvent(\"mouseup\", eventInit));\n}\n\n/**\n * Dispatch a `mousemove` event, with x and y defined relative to the container element.\n * @param x The x location of the event, relative to the x location of `container`.\n * @param y The y location of the event, relative to the y location of `container`.\n * @param container The DOM element for relative location of the event.\n */\nexport function mouseDown(x: number, y: number, container: Element) {\n  const containerRect = container.getBoundingClientRect();\n\n  const eventInit = {\n    clientX: containerRect.x + x,\n    clientY: containerRect.y + y,\n    bubbles: true,\n  };\n\n  container.dispatchEvent(new MouseEvent(\"mousedown\", eventInit));\n}\n\n/**\n * https://github.com/facebook/jest/issues/2157#issuecomment-279171856\n */\nexport function flushPromises() {\n  return new Promise((resolve) => flushMicroTasks(resolve));\n}\n\n/**\n * Runs the given timeline by calling `jsPsych.run()` on the provided JsPsych object.\n *\n * @param timeline The timeline that is passed to `jsPsych.run()`\n * @param jsPsych The jsPsych instance to be used. If left empty, a new instance will be created. If\n * a settings object is passed instead, the settings will be used to create the jsPsych instance.\n *\n * @returns An object containing test helper functions, the jsPsych instance, and the jsPsych\n * display element\n */\nexport async function startTimeline(timeline: any[], jsPsych: JsPsych | any = {}) {\n  const jsPsychInstance = jsPsych instanceof JsPsych ? jsPsych : new JsPsych(jsPsych);\n\n  let hasFinished = false;\n  const finished = jsPsychInstance.run(timeline).then(() => {\n    hasFinished = true;\n  });\n  await flushPromises();\n\n  const displayElement = jsPsychInstance.getDisplayElement();\n\n  return {\n    jsPsych: jsPsychInstance,\n    displayElement,\n    /** Shorthand for `jsPsych.getDisplayElement().innerHTML` */\n    getHTML: () => displayElement.innerHTML,\n    /** Shorthand for `jsPsych.data.get()` */\n    getData: () => jsPsychInstance.data.get(),\n    expectFinished: async () => {\n      await flushPromises();\n      expect(hasFinished).toBe(true);\n    },\n    expectRunning: async () => {\n      await flushPromises();\n      expect(hasFinished).toBe(false);\n    },\n    /** A promise that is resolved when `jsPsych.run()` is done. */\n    finished,\n  };\n}\n\n/**\n * Runs the given timeline by calling `jsPsych.simulate()` on the provided JsPsych object.\n *\n * @param timeline The timeline that is passed to `jsPsych.run()`\n * @param simulation_mode Either 'data-only' mode or 'visual' mode.\n * @param simulation_options Options to pass to `jsPsych.simulate()`\n * @param jsPsych The jsPsych instance to be used. If left empty, a new instance will be created. If\n * a settings object is passed instead, the settings will be used to create the jsPsych instance.\n *\n * @returns An object containing test helper functions, the jsPsych instance, and the jsPsych\n * display element\n */\nexport async function simulateTimeline(\n  timeline: any[],\n  simulation_mode: \"data-only\" | \"visual\" = \"data-only\",\n  simulation_options: any = {},\n  jsPsych: JsPsych | any = {}\n) {\n  const jsPsychInstance = jsPsych instanceof JsPsych ? jsPsych : new JsPsych(jsPsych);\n\n  let hasFinished = false;\n  const finished = jsPsychInstance\n    .simulate(timeline, simulation_mode, simulation_options)\n    .then(() => {\n      hasFinished = true;\n    });\n  await flushPromises();\n\n  const displayElement = jsPsychInstance.getDisplayElement();\n\n  return {\n    jsPsych: jsPsychInstance,\n    displayElement,\n    /** Shorthand for `jsPsych.getDisplayElement().innerHTML` */\n    getHTML: () => displayElement.innerHTML,\n    /** Shorthand for `jsPsych.data.get()` */\n    getData: () => jsPsychInstance.data.get(),\n    expectFinished: async () => {\n      await flushPromises();\n      expect(hasFinished).toBe(true);\n    },\n    expectRunning: async () => {\n      await flushPromises();\n      expect(hasFinished).toBe(false);\n    },\n    /** A promise that is resolved when `jsPsych.simulate()` is done. */\n    finished,\n  };\n}\n"],"names":["flushMicroTasks"],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jspsych/test-utils",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "description": "Test utility functions for jsPsych-related test cases",
   "type": "module",
   "main": "dist/index.cjs",
@@ -33,6 +33,6 @@
     "jspsych": ">=7.0.0"
   },
   "devDependencies": {
-    "@jspsych/config": "^1.0.0"
+    "@jspsych/config": "^1.1.0"
   }
 }

package/src/index.ts

@@ -28,6 +28,60 @@ export function clickTarget(target: Element) {
   target.dispatchEvent(new MouseEvent("click", { bubbles: true }));
 }
 
+/**
+ * Dispatch a `mousemove` event, with x and y defined relative to the container element.
+ * @param x The x location of the event, relative to the x location of `container`.
+ * @param y The y location of the event, relative to the y location of `container`.
+ * @param container The DOM element for relative location of the event.
+ */
+export function mouseMove(x: number, y: number, container: Element) {
+  const containerRect = container.getBoundingClientRect();
+
+  const eventInit = {
+    clientX: containerRect.x + x,
+    clientY: containerRect.y + y,
+    bubbles: true,
+  };
+
+  container.dispatchEvent(new MouseEvent("mousemove", eventInit));
+}
+
+/**
+ * Dispatch a `mouseup` event, with x and y defined relative to the container element.
+ * @param x The x location of the event, relative to the x location of `container`.
+ * @param y The y location of the event, relative to the y location of `container`.
+ * @param container The DOM element for relative location of the event.
+ */
+export function mouseUp(x: number, y: number, container: Element) {
+  const containerRect = container.getBoundingClientRect();
+
+  const eventInit = {
+    clientX: containerRect.x + x,
+    clientY: containerRect.y + y,
+    bubbles: true,
+  };
+
+  container.dispatchEvent(new MouseEvent("mouseup", eventInit));
+}
+
+/**
+ * Dispatch a `mousemove` event, with x and y defined relative to the container element.
+ * @param x The x location of the event, relative to the x location of `container`.
+ * @param y The y location of the event, relative to the y location of `container`.
+ * @param container The DOM element for relative location of the event.
+ */
+export function mouseDown(x: number, y: number, container: Element) {
+  const containerRect = container.getBoundingClientRect();
+
+  const eventInit = {
+    clientX: containerRect.x + x,
+    clientY: containerRect.y + y,
+    bubbles: true,
+  };
+
+  container.dispatchEvent(new MouseEvent("mousedown", eventInit));
+}
+
 /**
  * https://github.com/facebook/jest/issues/2157#issuecomment-279171856
  */
@@ -75,3 +129,53 @@ export async function startTimeline(timeline: any[], jsPsych: JsPsych | any = {}
     finished,
   };
 }
+
+/**
+ * Runs the given timeline by calling `jsPsych.simulate()` on the provided JsPsych object.
+ *
+ * @param timeline The timeline that is passed to `jsPsych.run()`
+ * @param simulation_mode Either 'data-only' mode or 'visual' mode.
+ * @param simulation_options Options to pass to `jsPsych.simulate()`
+ * @param jsPsych The jsPsych instance to be used. If left empty, a new instance will be created. If
+ * a settings object is passed instead, the settings will be used to create the jsPsych instance.
+ *
+ * @returns An object containing test helper functions, the jsPsych instance, and the jsPsych
+ * display element
+ */
+export async function simulateTimeline(
+  timeline: any[],
+  simulation_mode: "data-only" | "visual" = "data-only",
+  simulation_options: any = {},
+  jsPsych: JsPsych | any = {}
+) {
+  const jsPsychInstance = jsPsych instanceof JsPsych ? jsPsych : new JsPsych(jsPsych);
+
+  let hasFinished = false;
+  const finished = jsPsychInstance
+    .simulate(timeline, simulation_mode, simulation_options)
+    .then(() => {
+      hasFinished = true;
+    });
+  await flushPromises();
+
+  const displayElement = jsPsychInstance.getDisplayElement();
+
+  return {
+    jsPsych: jsPsychInstance,
+    displayElement,
+    /** Shorthand for `jsPsych.getDisplayElement().innerHTML` */
+    getHTML: () => displayElement.innerHTML,
+    /** Shorthand for `jsPsych.data.get()` */
+    getData: () => jsPsychInstance.data.get(),
+    expectFinished: async () => {
+      await flushPromises();
+      expect(hasFinished).toBe(true);
+    },
+    expectRunning: async () => {
+      await flushPromises();
+      expect(hasFinished).toBe(false);
+    },
+    /** A promise that is resolved when `jsPsych.simulate()` is done. */
+    finished,
+  };
+}