jspsych 7.0.0 → 7.1.0

package/dist/index.cjs

@@ -69,7 +69,38 @@ var autoBind = (self, {include, exclude} = {}) => {
 	return self;
 };
 
-var version = "7.0.0";
+var version = "7.1.0";
+
+class MigrationError extends Error {
+    constructor(message = "The global `jsPsych` variable is no longer available in jsPsych v7.") {
+        super(`${message} Please follow the migration guide at https://www.jspsych.org/7.0/support/migration-v7/ to update your experiment.`);
+        this.name = "MigrationError";
+    }
+}
+// Define a global jsPsych object to handle invocations on it with migration errors
+window.jsPsych = {
+    get init() {
+        throw new MigrationError("`jsPsych.init()` was replaced by `initJsPsych()` in jsPsych v7.");
+    },
+    get data() {
+        throw new MigrationError();
+    },
+    get randomization() {
+        throw new MigrationError();
+    },
+    get turk() {
+        throw new MigrationError();
+    },
+    get pluginAPI() {
+        throw new MigrationError();
+    },
+    get ALL_KEYS() {
+        throw new MigrationError('jsPsych.ALL_KEYS was replaced by the "ALL_KEYS" string in jsPsych v7.');
+    },
+    get NO_KEYS() {
+        throw new MigrationError('jsPsych.NO_KEYS was replaced by the "NO_KEYS" string in jsPsych v7.');
+    },
+};
 
 /**
  * Finds all of the unique items in an array.
@@ -799,6 +830,7 @@ class MediaAPI {
         this.preload_requests = [];
         this.img_cache = {};
         this.preloadMap = new Map();
+        this.microphone_recorder = null;
     }
     getVideoBuffer(videoID) {
         return this.video_buffers[videoID];
@@ -1035,6 +1067,184 @@ class MediaAPI {
         }
         this.preload_requests = [];
     }
+    initializeMicrophoneRecorder(stream) {
+        const recorder = new MediaRecorder(stream);
+        this.microphone_recorder = recorder;
+    }
+    getMicrophoneRecorder() {
+        return this.microphone_recorder;
+    }
+}
+
+class SimulationAPI {
+    dispatchEvent(event) {
+        document.body.dispatchEvent(event);
+    }
+    /**
+     * Dispatches a `keydown` event for the specified key
+     * @param key Character code (`.key` property) for the key to press.
+     */
+    keyDown(key) {
+        this.dispatchEvent(new KeyboardEvent("keydown", { key }));
+    }
+    /**
+     * Dispatches a `keyup` event for the specified key
+     * @param key Character code (`.key` property) for the key to press.
+     */
+    keyUp(key) {
+        this.dispatchEvent(new KeyboardEvent("keyup", { key }));
+    }
+    /**
+     * Dispatches a `keydown` and `keyup` event in sequence to simulate pressing a key.
+     * @param key Character code (`.key` property) for the key to press.
+     * @param delay Length of time to wait (ms) before executing action
+     */
+    pressKey(key, delay = 0) {
+        if (delay > 0) {
+            setTimeout(() => {
+                this.keyDown(key);
+                this.keyUp(key);
+            }, delay);
+        }
+        else {
+            this.keyDown(key);
+            this.keyUp(key);
+        }
+    }
+    /**
+     * Dispatches `mousedown`, `mouseup`, and `click` events on the target element
+     * @param target The element to click
+     * @param delay Length of time to wait (ms) before executing action
+     */
+    clickTarget(target, delay = 0) {
+        if (delay > 0) {
+            setTimeout(() => {
+                target.dispatchEvent(new MouseEvent("mousedown", { bubbles: true }));
+                target.dispatchEvent(new MouseEvent("mouseup", { bubbles: true }));
+                target.dispatchEvent(new MouseEvent("click", { bubbles: true }));
+            }, delay);
+        }
+        else {
+            target.dispatchEvent(new MouseEvent("mousedown", { bubbles: true }));
+            target.dispatchEvent(new MouseEvent("mouseup", { bubbles: true }));
+            target.dispatchEvent(new MouseEvent("click", { bubbles: true }));
+        }
+    }
+    /**
+     * Sets the value of a target text input
+     * @param target A text input element to fill in
+     * @param text Text to input
+     * @param delay Length of time to wait (ms) before executing action
+     */
+    fillTextInput(target, text, delay = 0) {
+        if (delay > 0) {
+            setTimeout(() => {
+                target.value = text;
+            }, delay);
+        }
+        else {
+            target.value = text;
+        }
+    }
+    /**
+     * Picks a valid key from `choices`, taking into account jsPsych-specific
+     * identifiers like "NO_KEYS" and "ALL_KEYS".
+     * @param choices Which keys are valid.
+     * @returns A key selected at random from the valid keys.
+     */
+    getValidKey(choices) {
+        const possible_keys = [
+            "a",
+            "b",
+            "c",
+            "d",
+            "e",
+            "f",
+            "g",
+            "h",
+            "i",
+            "j",
+            "k",
+            "l",
+            "m",
+            "n",
+            "o",
+            "p",
+            "q",
+            "r",
+            "s",
+            "t",
+            "u",
+            "v",
+            "w",
+            "x",
+            "y",
+            "z",
+            "0",
+            "1",
+            "2",
+            "3",
+            "4",
+            "5",
+            "6",
+            "7",
+            "8",
+            "9",
+            " ",
+        ];
+        let key;
+        if (choices == "NO_KEYS") {
+            key = null;
+        }
+        else if (choices == "ALL_KEYS") {
+            key = possible_keys[Math.floor(Math.random() * possible_keys.length)];
+        }
+        else {
+            const flat_choices = choices.flat();
+            key = flat_choices[Math.floor(Math.random() * flat_choices.length)];
+        }
+        return key;
+    }
+    mergeSimulationData(default_data, simulation_options) {
+        // override any data with data from simulation object
+        return Object.assign(Object.assign({}, default_data), simulation_options === null || simulation_options === void 0 ? void 0 : simulation_options.data);
+    }
+    ensureSimulationDataConsistency(trial, data) {
+        // All RTs must be rounded
+        if (data.rt) {
+            data.rt = Math.round(data.rt);
+        }
+        // If a trial_duration and rt exist, make sure that the RT is not longer than the trial.
+        if (trial.trial_duration && data.rt && data.rt > trial.trial_duration) {
+            data.rt = null;
+            if (data.response) {
+                data.response = null;
+            }
+            if (data.correct) {
+                data.correct = false;
+            }
+        }
+        // If trial.choices is NO_KEYS make sure that response and RT are null
+        if (trial.choices && trial.choices == "NO_KEYS") {
+            if (data.rt) {
+                data.rt = null;
+            }
+            if (data.response) {
+                data.response = null;
+            }
+        }
+        // If response is not allowed before stimulus display complete, ensure RT
+        // is longer than display time.
+        if (trial.allow_response_before_complete) {
+            if (trial.sequence_reps && trial.frame_time) {
+                const min_time = trial.sequence_reps * trial.frame_time * trial.stimuli.length;
+                if (data.rt < min_time) {
+                    data.rt = null;
+                    data.response = null;
+                }
+            }
+        }
+    }
 }
 
 class TimeoutAPI {
@@ -1061,9 +1271,351 @@ function createJointPluginAPIObject(jsPsych) {
         new TimeoutAPI(),
         new MediaAPI(settings.use_webaudio, jsPsych.webaudio_context),
         new HardwareAPI(),
+        new SimulationAPI(),
     ].map((object) => autoBind(object)));
 }
 
+var wordList = [
+  // Borrowed from xkcd password generator which borrowed it from wherever
+  "ability","able","aboard","about","above","accept","accident","according",
+  "account","accurate","acres","across","act","action","active","activity",
+  "actual","actually","add","addition","additional","adjective","adult","adventure",
+  "advice","affect","afraid","after","afternoon","again","against","age",
+  "ago","agree","ahead","aid","air","airplane","alike","alive",
+  "all","allow","almost","alone","along","aloud","alphabet","already",
+  "also","although","am","among","amount","ancient","angle","angry",
+  "animal","announced","another","answer","ants","any","anybody","anyone",
+  "anything","anyway","anywhere","apart","apartment","appearance","apple","applied",
+  "appropriate","are","area","arm","army","around","arrange","arrangement",
+  "arrive","arrow","art","article","as","aside","ask","asleep",
+  "at","ate","atmosphere","atom","atomic","attached","attack","attempt",
+  "attention","audience","author","automobile","available","average","avoid","aware",
+  "away","baby","back","bad","badly","bag","balance","ball",
+  "balloon","band","bank","bar","bare","bark","barn","base",
+  "baseball","basic","basis","basket","bat","battle","be","bean",
+  "bear","beat","beautiful","beauty","became","because","become","becoming",
+  "bee","been","before","began","beginning","begun","behavior","behind",
+  "being","believed","bell","belong","below","belt","bend","beneath",
+  "bent","beside","best","bet","better","between","beyond","bicycle",
+  "bigger","biggest","bill","birds","birth","birthday","bit","bite",
+  "black","blank","blanket","blew","blind","block","blood","blow",
+  "blue","board","boat","body","bone","book","border","born",
+  "both","bottle","bottom","bound","bow","bowl","box","boy",
+  "brain","branch","brass","brave","bread","break","breakfast","breath",
+  "breathe","breathing","breeze","brick","bridge","brief","bright","bring",
+  "broad","broke","broken","brother","brought","brown","brush","buffalo",
+  "build","building","built","buried","burn","burst","bus","bush",
+  "business","busy","but","butter","buy","by","cabin","cage",
+  "cake","call","calm","came","camera","camp","can","canal",
+  "cannot","cap","capital","captain","captured","car","carbon","card",
+  "care","careful","carefully","carried","carry","case","cast","castle",
+  "cat","catch","cattle","caught","cause","cave","cell","cent",
+  "center","central","century","certain","certainly","chain","chair","chamber",
+  "chance","change","changing","chapter","character","characteristic","charge","chart",
+  "check","cheese","chemical","chest","chicken","chief","child","children",
+  "choice","choose","chose","chosen","church","circle","circus","citizen",
+  "city","class","classroom","claws","clay","clean","clear","clearly",
+  "climate","climb","clock","close","closely","closer","cloth","clothes",
+  "clothing","cloud","club","coach","coal","coast","coat","coffee",
+  "cold","collect","college","colony","color","column","combination","combine",
+  "come","comfortable","coming","command","common","community","company","compare",
+  "compass","complete","completely","complex","composed","composition","compound","concerned",
+  "condition","congress","connected","consider","consist","consonant","constantly","construction",
+  "contain","continent","continued","contrast","control","conversation","cook","cookies",
+  "cool","copper","copy","corn","corner","correct","correctly","cost",
+  "cotton","could","count","country","couple","courage","course","court",
+  "cover","cow","cowboy","crack","cream","create","creature","crew",
+  "crop","cross","crowd","cry","cup","curious","current","curve",
+  "customs","cut","cutting","daily","damage","dance","danger","dangerous",
+  "dark","darkness","date","daughter","dawn","day","dead","deal",
+  "dear","death","decide","declared","deep","deeply","deer","definition",
+  "degree","depend","depth","describe","desert","design","desk","detail",
+  "determine","develop","development","diagram","diameter","did","die","differ",
+  "difference","different","difficult","difficulty","dig","dinner","direct","direction",
+  "directly","dirt","dirty","disappear","discover","discovery","discuss","discussion",
+  "disease","dish","distance","distant","divide","division","do","doctor",
+  "does","dog","doing","doll","dollar","done","donkey","door",
+  "dot","double","doubt","down","dozen","draw","drawn","dream",
+  "dress","drew","dried","drink","drive","driven","driver","driving",
+  "drop","dropped","drove","dry","duck","due","dug","dull",
+  "during","dust","duty","each","eager","ear","earlier","early",
+  "earn","earth","easier","easily","east","easy","eat","eaten",
+  "edge","education","effect","effort","egg","eight","either","electric",
+  "electricity","element","elephant","eleven","else","empty","end","enemy",
+  "energy","engine","engineer","enjoy","enough","enter","entire","entirely",
+  "environment","equal","equally","equator","equipment","escape","especially","essential",
+  "establish","even","evening","event","eventually","ever","every","everybody",
+  "everyone","everything","everywhere","evidence","exact","exactly","examine","example",
+  "excellent","except","exchange","excited","excitement","exciting","exclaimed","exercise",
+  "exist","expect","experience","experiment","explain","explanation","explore","express",
+  "expression","extra","eye","face","facing","fact","factor","factory",
+  "failed","fair","fairly","fall","fallen","familiar","family","famous",
+  "far","farm","farmer","farther","fast","fastened","faster","fat",
+  "father","favorite","fear","feathers","feature","fed","feed","feel",
+  "feet","fell","fellow","felt","fence","few","fewer","field",
+  "fierce","fifteen","fifth","fifty","fight","fighting","figure","fill",
+  "film","final","finally","find","fine","finest","finger","finish",
+  "fire","fireplace","firm","first","fish","five","fix","flag",
+  "flame","flat","flew","flies","flight","floating","floor","flow",
+  "flower","fly","fog","folks","follow","food","foot","football",
+  "for","force","foreign","forest","forget","forgot","forgotten","form",
+  "former","fort","forth","forty","forward","fought","found","four",
+  "fourth","fox","frame","free","freedom","frequently","fresh","friend",
+  "friendly","frighten","frog","from","front","frozen","fruit","fuel",
+  "full","fully","fun","function","funny","fur","furniture","further",
+  "future","gain","game","garage","garden","gas","gasoline","gate",
+  "gather","gave","general","generally","gentle","gently","get","getting",
+  "giant","gift","girl","give","given","giving","glad","glass",
+  "globe","go","goes","gold","golden","gone","good","goose",
+  "got","government","grabbed","grade","gradually","grain","grandfather","grandmother",
+  "graph","grass","gravity","gray","great","greater","greatest","greatly",
+  "green","grew","ground","group","grow","grown","growth","guard",
+  "guess","guide","gulf","gun","habit","had","hair","half",
+  "halfway","hall","hand","handle","handsome","hang","happen","happened",
+  "happily","happy","harbor","hard","harder","hardly","has","hat",
+  "have","having","hay","he","headed","heading","health","heard",
+  "hearing","heart","heat","heavy","height","held","hello","help",
+  "helpful","her","herd","here","herself","hidden","hide","high",
+  "higher","highest","highway","hill","him","himself","his","history",
+  "hit","hold","hole","hollow","home","honor","hope","horn",
+  "horse","hospital","hot","hour","house","how","however","huge",
+  "human","hundred","hung","hungry","hunt","hunter","hurried","hurry",
+  "hurt","husband","ice","idea","identity","if","ill","image",
+  "imagine","immediately","importance","important","impossible","improve","in","inch",
+  "include","including","income","increase","indeed","independent","indicate","individual",
+  "industrial","industry","influence","information","inside","instance","instant","instead",
+  "instrument","interest","interior","into","introduced","invented","involved","iron",
+  "is","island","it","its","itself","jack","jar","jet",
+  "job","join","joined","journey","joy","judge","jump","jungle",
+  "just","keep","kept","key","kids","kill","kind","kitchen",
+  "knew","knife","know","knowledge","known","label","labor","lack",
+  "lady","laid","lake","lamp","land","language","large","larger",
+  "largest","last","late","later","laugh","law","lay","layers",
+  "lead","leader","leaf","learn","least","leather","leave","leaving",
+  "led","left","leg","length","lesson","let","letter","level",
+  "library","lie","life","lift","light","like","likely","limited",
+  "line","lion","lips","liquid","list","listen","little","live",
+  "living","load","local","locate","location","log","lonely","long",
+  "longer","look","loose","lose","loss","lost","lot","loud",
+  "love","lovely","low","lower","luck","lucky","lunch","lungs",
+  "lying","machine","machinery","mad","made","magic","magnet","mail",
+  "main","mainly","major","make","making","man","managed","manner",
+  "manufacturing","many","map","mark","market","married","mass","massage",
+  "master","material","mathematics","matter","may","maybe","me","meal",
+  "mean","means","meant","measure","meat","medicine","meet","melted",
+  "member","memory","men","mental","merely","met","metal","method",
+  "mice","middle","might","mighty","mile","military","milk","mill",
+  "mind","mine","minerals","minute","mirror","missing","mission","mistake",
+  "mix","mixture","model","modern","molecular","moment","money","monkey",
+  "month","mood","moon","more","morning","most","mostly","mother",
+  "motion","motor","mountain","mouse","mouth","move","movement","movie",
+  "moving","mud","muscle","music","musical","must","my","myself",
+  "mysterious","nails","name","nation","national","native","natural","naturally",
+  "nature","near","nearby","nearer","nearest","nearly","necessary","neck",
+  "needed","needle","needs","negative","neighbor","neighborhood","nervous","nest",
+  "never","new","news","newspaper","next","nice","night","nine",
+  "no","nobody","nodded","noise","none","noon","nor","north",
+  "nose","not","note","noted","nothing","notice","noun","now",
+  "number","numeral","nuts","object","observe","obtain","occasionally","occur",
+  "ocean","of","off","offer","office","officer","official","oil",
+  "old","older","oldest","on","once","one","only","onto",
+  "open","operation","opinion","opportunity","opposite","or","orange","orbit",
+  "order","ordinary","organization","organized","origin","original","other","ought",
+  "our","ourselves","out","outer","outline","outside","over","own",
+  "owner","oxygen","pack","package","page","paid","pain","paint",
+  "pair","palace","pale","pan","paper","paragraph","parallel","parent",
+  "park","part","particles","particular","particularly","partly","parts","party",
+  "pass","passage","past","path","pattern","pay","peace","pen",
+  "pencil","people","per","percent","perfect","perfectly","perhaps","period",
+  "person","personal","pet","phrase","physical","piano","pick","picture",
+  "pictured","pie","piece","pig","pile","pilot","pine","pink",
+  "pipe","pitch","place","plain","plan","plane","planet","planned",
+  "planning","plant","plastic","plate","plates","play","pleasant","please",
+  "pleasure","plenty","plural","plus","pocket","poem","poet","poetry",
+  "point","pole","police","policeman","political","pond","pony","pool",
+  "poor","popular","population","porch","port","position","positive","possible",
+  "possibly","post","pot","potatoes","pound","pour","powder","power",
+  "powerful","practical","practice","prepare","present","president","press","pressure",
+  "pretty","prevent","previous","price","pride","primitive","principal","principle",
+  "printed","private","prize","probably","problem","process","produce","product",
+  "production","program","progress","promised","proper","properly","property","protection",
+  "proud","prove","provide","public","pull","pupil","pure","purple",
+  "purpose","push","put","putting","quarter","queen","question","quick",
+  "quickly","quiet","quietly","quite","rabbit","race","radio","railroad",
+  "rain","raise","ran","ranch","range","rapidly","rate","rather",
+  "raw","rays","reach","read","reader","ready","real","realize",
+  "rear","reason","recall","receive","recent","recently","recognize","record",
+  "red","refer","refused","region","regular","related","relationship","religious",
+  "remain","remarkable","remember","remove","repeat","replace","replied","report",
+  "represent","require","research","respect","rest","result","return","review",
+  "rhyme","rhythm","rice","rich","ride","riding","right","ring",
+  "rise","rising","river","road","roar","rock","rocket","rocky",
+  "rod","roll","roof","room","root","rope","rose","rough",
+  "round","route","row","rubbed","rubber","rule","ruler","run",
+  "running","rush","sad","saddle","safe","safety","said","sail",
+  "sale","salmon","salt","same","sand","sang","sat","satellites",
+  "satisfied","save","saved","saw","say","scale","scared","scene",
+  "school","science","scientific","scientist","score","screen","sea","search",
+  "season","seat","second","secret","section","see","seed","seeing",
+  "seems","seen","seldom","select","selection","sell","send","sense",
+  "sent","sentence","separate","series","serious","serve","service","sets",
+  "setting","settle","settlers","seven","several","shade","shadow","shake",
+  "shaking","shall","shallow","shape","share","sharp","she","sheep",
+  "sheet","shelf","shells","shelter","shine","shinning","ship","shirt",
+  "shoe","shoot","shop","shore","short","shorter","shot","should",
+  "shoulder","shout","show","shown","shut","sick","sides","sight",
+  "sign","signal","silence","silent","silk","silly","silver","similar",
+  "simple","simplest","simply","since","sing","single","sink","sister",
+  "sit","sitting","situation","six","size","skill","skin","sky",
+  "slabs","slave","sleep","slept","slide","slight","slightly","slip",
+  "slipped","slope","slow","slowly","small","smaller","smallest","smell",
+  "smile","smoke","smooth","snake","snow","so","soap","social",
+  "society","soft","softly","soil","solar","sold","soldier","solid",
+  "solution","solve","some","somebody","somehow","someone","something","sometime",
+  "somewhere","son","song","soon","sort","sound","source","south",
+  "southern","space","speak","special","species","specific","speech","speed",
+  "spell","spend","spent","spider","spin","spirit","spite","split",
+  "spoken","sport","spread","spring","square","stage","stairs","stand",
+  "standard","star","stared","start","state","statement","station","stay",
+  "steady","steam","steel","steep","stems","step","stepped","stick",
+  "stiff","still","stock","stomach","stone","stood","stop","stopped",
+  "store","storm","story","stove","straight","strange","stranger","straw",
+  "stream","street","strength","stretch","strike","string","strip","strong",
+  "stronger","struck","structure","struggle","stuck","student","studied","studying",
+  "subject","substance","success","successful","such","sudden","suddenly","sugar",
+  "suggest","suit","sum","summer","sun","sunlight","supper","supply",
+  "support","suppose","sure","surface","surprise","surrounded","swam","sweet",
+  "swept","swim","swimming","swing","swung","syllable","symbol","system",
+  "table","tail","take","taken","tales","talk","tall","tank",
+  "tape","task","taste","taught","tax","tea","teach","teacher",
+  "team","tears","teeth","telephone","television","tell","temperature","ten",
+  "tent","term","terrible","test","than","thank","that","thee",
+  "them","themselves","then","theory","there","therefore","these","they",
+  "thick","thin","thing","think","third","thirty","this","those",
+  "thou","though","thought","thousand","thread","three","threw","throat",
+  "through","throughout","throw","thrown","thumb","thus","thy","tide",
+  "tie","tight","tightly","till","time","tin","tiny","tip",
+  "tired","title","to","tobacco","today","together","told","tomorrow",
+  "tone","tongue","tonight","too","took","tool","top","topic",
+  "torn","total","touch","toward","tower","town","toy","trace",
+  "track","trade","traffic","trail","train","transportation","trap","travel",
+  "treated","tree","triangle","tribe","trick","tried","trip","troops",
+  "tropical","trouble","truck","trunk","truth","try","tube","tune",
+  "turn","twelve","twenty","twice","two","type","typical","uncle",
+  "under","underline","understanding","unhappy","union","unit","universe","unknown",
+  "unless","until","unusual","up","upon","upper","upward","us",
+  "use","useful","using","usual","usually","valley","valuable","value",
+  "vapor","variety","various","vast","vegetable","verb","vertical","very",
+  "vessels","victory","view","village","visit","visitor","voice","volume",
+  "vote","vowel","voyage","wagon","wait","walk","wall","want",
+  "war","warm","warn","was","wash","waste","watch","water",
+  "wave","way","we","weak","wealth","wear","weather","week",
+  "weigh","weight","welcome","well","went","were","west","western",
+  "wet","whale","what","whatever","wheat","wheel","when","whenever",
+  "where","wherever","whether","which","while","whispered","whistle","white",
+  "who","whole","whom","whose","why","wide","widely","wife",
+  "wild","will","willing","win","wind","window","wing","winter",
+  "wire","wise","wish","with","within","without","wolf","women",
+  "won","wonder","wonderful","wood","wooden","wool","word","wore",
+  "work","worker","world","worried","worry","worse","worth","would",
+  "wrapped","write","writer","writing","written","wrong","wrote","yard",
+  "year","yellow","yes","yesterday","yet","you","young","younger",
+  "your","yourself","youth","zero","zebra","zipper","zoo","zulu"
+];
+
+function words(options) {
+
+  function word() {
+    if (options && options.maxLength > 1) {
+      return generateWordWithMaxLength();
+    } else {
+      return generateRandomWord();
+    }
+  }
+
+  function generateWordWithMaxLength() {
+    var rightSize = false;
+    var wordUsed;
+    while (!rightSize) {  
+      wordUsed = generateRandomWord();
+      if(wordUsed.length <= options.maxLength) {
+        rightSize = true;
+      }
+
+    }
+    return wordUsed;
+  }
+
+  function generateRandomWord() {
+    return wordList[randInt(wordList.length)];
+  }
+
+  function randInt(lessThan) {
+    return Math.floor(Math.random() * lessThan);
+  }
+
+  // No arguments = generate one word
+  if (typeof(options) === 'undefined') {
+    return word();
+  }
+
+  // Just a number = return that many words
+  if (typeof(options) === 'number') {
+    options = { exactly: options };
+  }
+
+  // options supported: exactly, min, max, join
+  if (options.exactly) {
+    options.min = options.exactly;
+    options.max = options.exactly;
+  }
+  
+  // not a number = one word par string
+  if (typeof(options.wordsPerString) !== 'number') {
+    options.wordsPerString = 1;
+  }
+
+  //not a function = returns the raw word
+  if (typeof(options.formatter) !== 'function') {
+    options.formatter = (word) => word;
+  }
+
+  //not a string = separator is a space
+  if (typeof(options.separator) !== 'string') {
+    options.separator = ' ';
+  }
+
+  var total = options.min + randInt(options.max + 1 - options.min);
+  var results = [];
+  var token = '';
+  var relativeIndex = 0;
+
+  for (var i = 0; (i < total * options.wordsPerString); i++) {
+    if (relativeIndex === options.wordsPerString - 1) {
+      token += options.formatter(word(), relativeIndex);
+    }
+    else {
+      token += options.formatter(word(), relativeIndex) + options.separator;
+    }
+    relativeIndex++;
+    if ((i + 1) % options.wordsPerString === 0) {
+      results.push(token);
+      token = ''; 
+      relativeIndex = 0;
+    }
+   
+  }
+  if (typeof options.join === 'string') {
+    results = results.join(options.join);
+  }
+
+  return results;
+}
+
+var randomWords$1 = words;
+// Export the word list as it is often useful
+words.wordList = wordList;
+
 function repeat(array, repetitions, unpack = false) {
     const arr_isArray = Array.isArray(array);
     const rep_isArray = Array.isArray(repetitions);
@@ -1273,6 +1825,64 @@ function randomID(length = 32) {
     }
     return result;
 }
+/**
+ * Generate a random integer from `lower` to `upper`, inclusive of both end points.
+ * @param lower The lowest value it is possible to generate
+ * @param upper The highest value it is possible to generate
+ * @returns A random integer
+ */
+function randomInt(lower, upper) {
+    if (upper < lower) {
+        throw new Error("Upper boundary must be less than or equal to lower boundary");
+    }
+    return lower + Math.floor(Math.random() * (upper - lower + 1));
+}
+/**
+ * Generates a random sample from a Bernoulli distribution.
+ * @param p The probability of sampling 1.
+ * @returns 0, with probability 1-p, or 1, with probability p.
+ */
+function sampleBernoulli(p) {
+    return Math.random() <= p ? 1 : 0;
+}
+function sampleNormal(mean, standard_deviation) {
+    return randn_bm() * standard_deviation + mean;
+}
+function sampleExponential(rate) {
+    return -Math.log(Math.random()) / rate;
+}
+function sampleExGaussian(mean, standard_deviation, rate, positive = false) {
+    let s = sampleNormal(mean, standard_deviation) + sampleExponential(rate);
+    if (positive) {
+        while (s <= 0) {
+            s = sampleNormal(mean, standard_deviation) + sampleExponential(rate);
+        }
+    }
+    return s;
+}
+/**
+ * Generate one or more random words.
+ *
+ * This is a wrapper function for the {@link https://www.npmjs.com/package/random-words `random-words` npm package}.
+ *
+ * @param opts An object with optional properties `min`, `max`, `exactly`,
+ * `join`, `maxLength`, `wordsPerString`, `separator`, and `formatter`.
+ *
+ * @returns An array of words or a single string, depending on parameter choices.
+ */
+function randomWords(opts) {
+    return randomWords$1(opts);
+}
+// Box-Muller transformation for a random sample from normal distribution with mean = 0, std = 1
+// https://stackoverflow.com/a/36481059/3726673
+function randn_bm() {
+    var u = 0, v = 0;
+    while (u === 0)
+        u = Math.random(); //Converting [0,1) to (0,1)
+    while (v === 0)
+        v = Math.random();
+    return Math.sqrt(-2.0 * Math.log(u)) * Math.cos(2.0 * Math.PI * v);
+}
 function unpackArray(array) {
     const out = {};
     for (const x of array) {
@@ -1295,7 +1905,13 @@ var randomization = /*#__PURE__*/Object.freeze({
     sampleWithoutReplacement: sampleWithoutReplacement,
     sampleWithReplacement: sampleWithReplacement,
     factorial: factorial,
-    randomID: randomID
+    randomID: randomID,
+    randomInt: randomInt,
+    sampleBernoulli: sampleBernoulli,
+    sampleNormal: sampleNormal,
+    sampleExponential: sampleExponential,
+    sampleExGaussian: sampleExGaussian,
+    randomWords: randomWords
 });
 
 /**
@@ -1842,6 +2458,10 @@ class JsPsych {
          * is the page retrieved directly via file:// protocol (true) or hosted on a server (false)?
          */
         this.file_protocol = false;
+        /**
+         * is the experiment running in `simulate()` mode
+         */
+        this.simulation_mode = null;
         // storing a single webaudio context to prevent problems with multiple inits
         // of jsPsych
         this.webaudio_context = null;
@@ -1911,6 +2531,13 @@ class JsPsych {
             yield this.finished;
         });
     }
+    simulate(timeline, simulation_mode, simulation_options = {}) {
+        return __awaiter(this, void 0, void 0, function* () {
+            this.simulation_mode = simulation_mode;
+            this.simulation_options = simulation_options;
+            yield this.run(timeline);
+        });
+    }
     getProgress() {
         return {
             total_trials: typeof this.timeline === "undefined" ? undefined : this.timeline.length(),
@@ -2013,12 +2640,12 @@ class JsPsych {
             }
         }
     }
-    endExperiment(end_message) {
+    endExperiment(end_message = "", data = {}) {
         this.timeline.end_message = end_message;
         this.timeline.end();
         this.pluginAPI.cancelAllKeyboardResponses();
         this.pluginAPI.clearAllTimeouts();
-        this.finishTrial();
+        this.finishTrial(data);
     }
     endCurrentTimeline() {
         this.timeline.endActiveNode();
@@ -2196,6 +2823,9 @@ class JsPsych {
         this.current_trial_finished = false;
         // process all timeline variables for this trial
         this.evaluateTimelineVariables(trial);
+        if (typeof trial.type === "string") {
+            throw new MigrationError("A string was provided as the trial's `type` parameter. Since jsPsych v7, the `type` parameter needs to be a plugin object.");
+        }
         // instantiate the plugin for this trial
         trial.type = Object.assign(Object.assign({}, autoBind(new trial.type(this))), { info: trial.type.info });
         // evaluate variables that are functions
@@ -2241,10 +2871,53 @@ class JsPsych {
                 }
             }
         };
-        const trial_complete = trial.type.trial(this.DOM_target, trial, load_callback);
+        let trial_complete;
+        if (!this.simulation_mode) {
+            trial_complete = trial.type.trial(this.DOM_target, trial, load_callback);
+        }
+        if (this.simulation_mode) {
+            // check if the trial supports simulation
+            if (trial.type.simulate) {
+                let trial_sim_opts;
+                if (!trial.simulation_options) {
+                    trial_sim_opts = this.simulation_options.default;
+                }
+                if (trial.simulation_options) {
+                    if (typeof trial.simulation_options == "string") {
+                        if (this.simulation_options[trial.simulation_options]) {
+                            trial_sim_opts = this.simulation_options[trial.simulation_options];
+                        }
+                        else if (this.simulation_options.default) {
+                            console.log(`No matching simulation options found for "${trial.simulation_options}". Using "default" options.`);
+                            trial_sim_opts = this.simulation_options.default;
+                        }
+                        else {
+                            console.log(`No matching simulation options found for "${trial.simulation_options}" and no "default" options provided. Using the default values provided by the plugin.`);
+                            trial_sim_opts = {};
+                        }
+                    }
+                    else {
+                        trial_sim_opts = trial.simulation_options;
+                    }
+                }
+                trial_sim_opts = this.utils.deepCopy(trial_sim_opts);
+                trial_sim_opts = this.replaceFunctionsWithValues(trial_sim_opts, null);
+                if ((trial_sim_opts === null || trial_sim_opts === void 0 ? void 0 : trial_sim_opts.simulate) === false) {
+                    trial_complete = trial.type.trial(this.DOM_target, trial, load_callback);
+                }
+                else {
+                    trial_complete = trial.type.simulate(trial, (trial_sim_opts === null || trial_sim_opts === void 0 ? void 0 : trial_sim_opts.mode) || this.simulation_mode, trial_sim_opts, load_callback);
+                }
+            }
+            else {
+                // trial doesn't have a simulate method, so just run as usual
+                trial_complete = trial.type.trial(this.DOM_target, trial, load_callback);
+            }
+        }
         // see if trial_complete is a Promise by looking for .then() function
         const is_promise = trial_complete && typeof trial_complete.then == "function";
-        if (!is_promise) {
+        // in simulation mode we let the simulate function call the load_callback always.
+        if (!is_promise && !this.simulation_mode) {
             load_callback();
         }
         // done with callbacks
@@ -2370,6 +3043,9 @@ class JsPsych {
     }
     checkExclusions(exclusions) {
         return __awaiter(this, void 0, void 0, function* () {
+            if (exclusions.min_width || exclusions.min_height || exclusions.audio) {
+                console.warn("The exclusions option in `initJsPsych()` is deprecated and will be removed in a future version. We recommend using the browser-check plugin instead. See https://www.jspsych.org/latest/plugins/browser-check/.");
+            }
             // MINIMUM SIZE
             if (exclusions.min_width || exclusions.min_height) {
                 const mw = exclusions.min_width || 0;
@@ -2450,7 +3126,30 @@ if (typeof window !== "undefined" &&
  * @returns A new JsPsych instance
  */
 function initJsPsych(options) {
-    return new JsPsych(options);
+    const jsPsych = new JsPsych(options);
+    // Handle invocations of non-existent v6 methods with migration errors
+    const migrationMessages = {
+        init: "`jsPsych.init()` was replaced by `initJsPsych()` in jsPsych v7.",
+        ALL_KEYS: 'jsPsych.ALL_KEYS was replaced by the "ALL_KEYS" string in jsPsych v7.',
+        NO_KEYS: 'jsPsych.NO_KEYS was replaced by the "NO_KEYS" string in jsPsych v7.',
+        // Getter functions that were renamed
+        currentTimelineNodeID: "`currentTimelineNodeID()` was renamed to `getCurrentTimelineNodeID()` in jsPsych v7.",
+        progress: "`progress()` was renamed to `getProgress()` in jsPsych v7.",
+        startTime: "`startTime()` was renamed to `getStartTime()` in jsPsych v7.",
+        totalTime: "`totalTime()` was renamed to `getTotalTime()` in jsPsych v7.",
+        currentTrial: "`currentTrial()` was renamed to `getCurrentTrial()` in jsPsych v7.",
+        initSettings: "`initSettings()` was renamed to `getInitSettings()` in jsPsych v7.",
+        allTimelineVariables: "`allTimelineVariables()` was renamed to `getAllTimelineVariables()` in jsPsych v7.",
+    };
+    Object.defineProperties(jsPsych, Object.fromEntries(Object.entries(migrationMessages).map(([key, message]) => [
+        key,
+        {
+            get() {
+                throw new MigrationError(message);
+            },
+        },
+    ])));
+    return jsPsych;
 }
 
 exports.JsPsych = JsPsych;