jspsych 7.1.1 → 7.2.1

package/dist/index.cjs

@@ -27,6 +27,8 @@ function __awaiter(thisArg, _arguments, P, generator) {
     });
 }
 
+var commonjsGlobal = typeof globalThis !== 'undefined' ? globalThis : typeof window !== 'undefined' ? window : typeof global !== 'undefined' ? global : typeof self !== 'undefined' ? self : {};
+
 // Gets all non-builtin properties up the prototype chain
 const getAllProperties = object => {
 	const properties = new Set();
@@ -69,7 +71,7 @@ var autoBind = (self, {include, exclude} = {}) => {
 	return self;
 };
 
-var version = "7.1.1";
+var version = "7.2.1";
 
 class MigrationError extends Error {
     constructor(message = "The global `jsPsych` variable is no longer available in jsPsych v7.") {
@@ -409,6 +411,9 @@ class DataCollection {
     filterCustom(fn) {
         return new DataCollection(this.trials.filter(fn));
     }
+    filterColumns(columns) {
+        return new DataCollection(this.trials.map((trial) => Object.fromEntries(columns.filter((key) => key in trial).map((key) => [key, trial[key]]))));
+    }
     select(column) {
         const values = [];
         for (const trial of this.trials) {
@@ -810,6 +815,13 @@ const universalPluginParameters = {
         pretty_name: "Custom CSS classes",
         default: null,
     },
+    /**
+     * Options to control simulation mode for the trial.
+     */
+    simulation_options: {
+        type: exports.ParameterType.COMPLEX,
+        default: null,
+    },
 };
 
 const preloadParameterTypes = [
@@ -1616,6 +1628,135 @@ var randomWords$1 = words;
 // Export the word list as it is often useful
 words.wordList = wordList;
 
+var alea = {exports: {}};
+
+(function (module) {
+// A port of an algorithm by Johannes Baagøe <baagoe@baagoe.com>, 2010
+// http://baagoe.com/en/RandomMusings/javascript/
+// https://github.com/nquinlan/better-random-numbers-for-javascript-mirror
+// Original work is under MIT license -
+
+// Copyright (C) 2010 by Johannes Baagøe <baagoe@baagoe.org>
+//
+// Permission is hereby granted, free of charge, to any person obtaining a copy
+// of this software and associated documentation files (the "Software"), to deal
+// in the Software without restriction, including without limitation the rights
+// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+// copies of the Software, and to permit persons to whom the Software is
+// furnished to do so, subject to the following conditions:
+//
+// The above copyright notice and this permission notice shall be included in
+// all copies or substantial portions of the Software.
+//
+// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+// THE SOFTWARE.
+
+
+
+(function(global, module, define) {
+
+function Alea(seed) {
+  var me = this, mash = Mash();
+
+  me.next = function() {
+    var t = 2091639 * me.s0 + me.c * 2.3283064365386963e-10; // 2^-32
+    me.s0 = me.s1;
+    me.s1 = me.s2;
+    return me.s2 = t - (me.c = t | 0);
+  };
+
+  // Apply the seeding algorithm from Baagoe.
+  me.c = 1;
+  me.s0 = mash(' ');
+  me.s1 = mash(' ');
+  me.s2 = mash(' ');
+  me.s0 -= mash(seed);
+  if (me.s0 < 0) { me.s0 += 1; }
+  me.s1 -= mash(seed);
+  if (me.s1 < 0) { me.s1 += 1; }
+  me.s2 -= mash(seed);
+  if (me.s2 < 0) { me.s2 += 1; }
+  mash = null;
+}
+
+function copy(f, t) {
+  t.c = f.c;
+  t.s0 = f.s0;
+  t.s1 = f.s1;
+  t.s2 = f.s2;
+  return t;
+}
+
+function impl(seed, opts) {
+  var xg = new Alea(seed),
+      state = opts && opts.state,
+      prng = xg.next;
+  prng.int32 = function() { return (xg.next() * 0x100000000) | 0; };
+  prng.double = function() {
+    return prng() + (prng() * 0x200000 | 0) * 1.1102230246251565e-16; // 2^-53
+  };
+  prng.quick = prng;
+  if (state) {
+    if (typeof(state) == 'object') copy(state, xg);
+    prng.state = function() { return copy(xg, {}); };
+  }
+  return prng;
+}
+
+function Mash() {
+  var n = 0xefc8249d;
+
+  var mash = function(data) {
+    data = String(data);
+    for (var i = 0; i < data.length; i++) {
+      n += data.charCodeAt(i);
+      var h = 0.02519603282416938 * n;
+      n = h >>> 0;
+      h -= n;
+      h *= n;
+      n = h >>> 0;
+      h -= n;
+      n += h * 0x100000000; // 2^32
+    }
+    return (n >>> 0) * 2.3283064365386963e-10; // 2^-32
+  };
+
+  return mash;
+}
+
+
+if (module && module.exports) {
+  module.exports = impl;
+} else if (define && define.amd) {
+  define(function() { return impl; });
+} else {
+  this.alea = impl;
+}
+
+})(
+  commonjsGlobal,
+  module,    // present in node.js
+  (typeof undefined) == 'function'    // present with an AMD loader
+);
+}(alea));
+
+var seedrandom = alea.exports;
+
+/**
+ * Uses the `seedrandom` package to replace Math.random() with a seedable PRNG.
+ *
+ * @param seed An optional seed. If none is given, a random seed will be generated.
+ * @returns The seed value.
+ */
+function setSeed(seed = Math.random().toString()) {
+    Math.random = seedrandom(seed);
+    return seed;
+}
 function repeat(array, repetitions, unpack = false) {
     const arr_isArray = Array.isArray(array);
     const rep_isArray = Array.isArray(repetitions);
@@ -1898,6 +2039,7 @@ function unpackArray(array) {
 
 var randomization = /*#__PURE__*/Object.freeze({
     __proto__: null,
+    setSeed: setSeed,
     repeat: repeat,
     shuffle: shuffle,
     shuffleNoRepeats: shuffleNoRepeats,
@@ -2622,7 +2764,10 @@ class JsPsych {
         // done with callbacks
         this.internal.call_immediate = false;
         // wait for iti
-        if (typeof current_trial.post_trial_gap === null ||
+        if (this.simulation_mode === "data-only") {
+            this.nextTrial();
+        }
+        else if (typeof current_trial.post_trial_gap === null ||
             typeof current_trial.post_trial_gap === "undefined") {
             if (this.opts.default_iti > 0) {
                 setTimeout(this.nextTrial, this.opts.default_iti);