jspsych 7.1.1 → 7.2.1

package/dist/index.browser.js

@@ -26,6 +26,8 @@ var jsPsychModule = (function (exports) {
         });
     }
 
+    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();
@@ -68,7 +70,7 @@ var jsPsychModule = (function (exports) {
     	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.") {
@@ -408,6 +410,9 @@ var jsPsychModule = (function (exports) {
         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) {
@@ -809,6 +814,13 @@ var jsPsychModule = (function (exports) {
             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 = [
@@ -1615,6 +1627,135 @@ var jsPsychModule = (function (exports) {
     // 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);
@@ -1897,6 +2038,7 @@ var jsPsychModule = (function (exports) {
 
     var randomization = /*#__PURE__*/Object.freeze({
         __proto__: null,
+        setSeed: setSeed,
         repeat: repeat,
         shuffle: shuffle,
         shuffleNoRepeats: shuffleNoRepeats,
@@ -2621,7 +2763,10 @@ var jsPsychModule = (function (exports) {
             // 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);