jspsych 7.3.2 → 7.3.4

package/README.md

@@ -48,9 +48,15 @@ See the [contributing to jsPsych](https://www.jspsych.org/latest/developers/cont
 
 ## Citation
 
-If you use this library in academic work, please cite the [paper that describes jsPsych](http://link.springer.com/article/10.3758%2Fs13428-014-0458-y):
+If you use this library in academic work, the preferred citation is:
 
-de Leeuw, J.R. (2015). jsPsych: A JavaScript library for creating behavioral experiments in a Web browser. *Behavior Research Methods*, _47_(1), 1-12. doi:10.3758/s13428-014-0458-y
+de Leeuw, J.R., Gilbert, R.A., & Luchterhandt, B. (2023). jsPsych: Enabling an open-source collaborative ecosystem of behavioral experiments. *Journal of Open Source Software*, *8*(85), 5351, [https://joss.theoj.org/papers/10.21105/joss.05351](https://joss.theoj.org/papers/10.21105/joss.05351).
+
+This paper is an updated description of jsPsych and includes all current core team members. It replaces the earlier paper that described jsPsych:
+
+de Leeuw, J.R. (2015). jsPsych: A JavaScript library for creating behavioral experiments in a Web browser. *Behavior Research Methods*, _47_(1), 1-12. doi:[10.3758/s13428-014-0458-y](http://link.springer.com/article/10.3758%2Fs13428-014-0458-y)
+
+Citations help us demonstrate that this library is used and valued, which allows us to continue working on it.
 
 ## Contributors
 
@@ -59,4 +65,4 @@ The project is currently managed by the core team of Josh de Leeuw ([@jodeleeuw]
 
 jsPsych was created by [Josh de Leeuw](http://www.twitter.com/joshdeleeuw).
 
-We're also grateful for the generous support from a [Mozilla Open Source Support award](https://www.mozilla.org/en-US/moss/), which funded development of the library from 2020-2021.
+We're also grateful for the generous support from a [Mozilla Open Source Support award](https://www.mozilla.org/en-US/moss/), which funded development of the library from 2020-2022.

package/css/jspsych.css

@@ -330,11 +330,9 @@
 }
 
 .jspsych-content {
-  max-width: 95%;
-  /* this is mainly an IE 10-11 fix */
+  max-width: 95%; /* this is mainly an IE 10-11 fix */
   text-align: center;
-  margin: auto;
-  /* this is for overflowing content */
+  margin: auto; /* this is for overflowing content */
 }
 
 .jspsych-top {

package/dist/JsPsych.d.ts

@@ -1,112 +1,112 @@
-import { JsPsychData } from "./modules/data";
-import { PluginAPI } from "./modules/plugin-api";
-import * as randomization from "./modules/randomization";
-import * as turk from "./modules/turk";
-import * as utils from "./modules/utils";
-export declare class JsPsych {
-    extensions: any;
-    turk: typeof turk;
-    randomization: typeof randomization;
-    utils: typeof utils;
-    data: JsPsychData;
-    pluginAPI: PluginAPI;
-    version(): any;
-    /**
-     * options
-     */
-    private opts;
-    /**
-     * experiment timeline
-     */
-    private timeline;
-    private timelineDescription;
-    private global_trial_index;
-    private current_trial;
-    private current_trial_finished;
-    private DOM_container;
-    private DOM_target;
-    /**
-     * time that the experiment began
-     */
-    private exp_start_time;
-    /**
-     * is the experiment paused?
-     */
-    private paused;
-    private waiting;
-    /**
-     * is the page retrieved directly via file:// protocol (true) or hosted on a server (false)?
-     */
-    private file_protocol;
-    /**
-     * Promise that is resolved when `finishExperiment()` is called
-     */
-    private finished;
-    private resolveFinishedPromise;
-    /**
-     * is the experiment running in `simulate()` mode
-     */
-    private simulation_mode;
-    /**
-     * simulation options passed in via `simulate()`
-     */
-    private simulation_options;
-    webaudio_context: AudioContext;
-    internal: {
-        /**
-         * this flag is used to determine whether we are in a scope where
-         * jsPsych.timelineVariable() should be executed immediately or
-         * whether it should return a function to access the variable later.
-         *
-         **/
-        call_immediate: boolean;
-    };
-    constructor(options?: any);
-    /**
-     * Starts an experiment using the provided timeline and returns a promise that is resolved when
-     * the experiment is finished.
-     *
-     * @param timeline The timeline to be run
-     */
-    run(timeline: any[]): Promise<void>;
-    simulate(timeline: any[], simulation_mode?: "data-only" | "visual", simulation_options?: {}): Promise<void>;
-    getProgress(): {
-        total_trials: number;
-        current_trial_global: number;
-        percent_complete: number;
-    };
-    getStartTime(): any;
-    getTotalTime(): number;
-    getDisplayElement(): HTMLElement;
-    getDisplayContainerElement(): HTMLElement;
-    finishTrial(data?: {}): void;
-    endExperiment(end_message?: string, data?: {}): void;
-    endCurrentTimeline(): void;
-    getCurrentTrial(): any;
-    getInitSettings(): any;
-    getCurrentTimelineNodeID(): any;
-    timelineVariable(varname: string, immediate?: boolean): any;
-    getAllTimelineVariables(): any;
-    addNodeToEndOfTimeline(new_timeline: any, preload_callback?: any): void;
-    pauseExperiment(): void;
-    resumeExperiment(): void;
-    loadFail(message: any): void;
-    getSafeModeStatus(): boolean;
-    getTimeline(): any[];
-    private prepareDom;
-    private loadExtensions;
-    private startExperiment;
-    private finishExperiment;
-    private nextTrial;
-    private doTrial;
-    private evaluateTimelineVariables;
-    private evaluateFunctionParameters;
-    private replaceFunctionsWithValues;
-    private setDefaultValues;
-    private checkExclusions;
-    private drawProgressBar;
-    private updateProgressBar;
-    private progress_bar_amount;
-    setProgressBar(proportion_complete: any): void;
-    getProgressBarCompleted(): number;
-}
+import { JsPsychData } from "./modules/data";
+import { PluginAPI } from "./modules/plugin-api";
+import * as randomization from "./modules/randomization";
+import * as turk from "./modules/turk";
+import * as utils from "./modules/utils";
+export declare class JsPsych {
+    extensions: any;
+    turk: typeof turk;
+    randomization: typeof randomization;
+    utils: typeof utils;
+    data: JsPsychData;
+    pluginAPI: PluginAPI;
+    version(): any;
+    /**
+     * options
+     */
+    private opts;
+    /**
+     * experiment timeline
+     */
+    private timeline;
+    private timelineDescription;
+    private global_trial_index;
+    private current_trial;
+    private current_trial_finished;
+    private DOM_container;
+    private DOM_target;
+    /**
+     * time that the experiment began
+     */
+    private exp_start_time;
+    /**
+     * is the experiment paused?
+     */
+    private paused;
+    private waiting;
+    /**
+     * is the page retrieved directly via file:// protocol (true) or hosted on a server (false)?
+     */
+    private file_protocol;
+    /**
+     * Promise that is resolved when `finishExperiment()` is called
+     */
+    private finished;
+    private resolveFinishedPromise;
+    /**
+     * is the experiment running in `simulate()` mode
+     */
+    private simulation_mode;
+    /**
+     * simulation options passed in via `simulate()`
+     */
+    private simulation_options;
+    webaudio_context: AudioContext;
+    internal: {
+        /**
+         * this flag is used to determine whether we are in a scope where
+         * jsPsych.timelineVariable() should be executed immediately or
+         * whether it should return a function to access the variable later.
+         *
+         **/
+        call_immediate: boolean;
+    };
+    constructor(options?: any);
+    /**
+     * Starts an experiment using the provided timeline and returns a promise that is resolved when
+     * the experiment is finished.
+     *
+     * @param timeline The timeline to be run
+     */
+    run(timeline: any[]): Promise<void>;
+    simulate(timeline: any[], simulation_mode?: "data-only" | "visual", simulation_options?: {}): Promise<void>;
+    getProgress(): {
+        total_trials: number;
+        current_trial_global: number;
+        percent_complete: number;
+    };
+    getStartTime(): any;
+    getTotalTime(): number;
+    getDisplayElement(): HTMLElement;
+    getDisplayContainerElement(): HTMLElement;
+    finishTrial(data?: {}): void;
+    endExperiment(end_message?: string, data?: {}): void;
+    endCurrentTimeline(): void;
+    getCurrentTrial(): any;
+    getInitSettings(): any;
+    getCurrentTimelineNodeID(): any;
+    timelineVariable(varname: string, immediate?: boolean): any;
+    getAllTimelineVariables(): any;
+    addNodeToEndOfTimeline(new_timeline: any, preload_callback?: any): void;
+    pauseExperiment(): void;
+    resumeExperiment(): void;
+    loadFail(message: any): void;
+    getSafeModeStatus(): boolean;
+    getTimeline(): any[];
+    private prepareDom;
+    private loadExtensions;
+    private startExperiment;
+    private finishExperiment;
+    private nextTrial;
+    private doTrial;
+    private evaluateTimelineVariables;
+    private evaluateFunctionParameters;
+    private replaceFunctionsWithValues;
+    private setDefaultValues;
+    private checkExclusions;
+    private drawProgressBar;
+    private updateProgressBar;
+    private progress_bar_amount;
+    setProgressBar(proportion_complete: any): void;
+    getProgressBarCompleted(): number;
+}

package/dist/TimelineNode.d.ts

@@ -1,34 +1,34 @@
-import { JsPsych } from "./JsPsych";
-export declare class TimelineNode {
-    private jsPsych;
-    relative_id: any;
-    parent_node: any;
-    trial_parameters: any;
-    timeline_parameters: any;
-    node_trial_data: any;
-    progress: any;
-    end_message?: string;
-    constructor(jsPsych: JsPsych, parameters: any, parent?: any, relativeID?: any);
-    trial(): any;
-    markCurrentTrialComplete(): void;
-    nextRepetiton(): void;
-    setTimelineVariablesOrder(): void;
-    nextSet(): void;
-    advance(): any;
-    isComplete(): any;
-    getTimelineVariableValue(variable_name: string): any;
-    findTimelineVariable(variable_name: any): any;
-    timelineVariable(variable_name: string): any;
-    allTimelineVariables(): any;
-    allTimelineVariablesNames(so_far?: any[]): any;
-    length(): number;
-    percentComplete(): number;
-    reset(): void;
-    end(): void;
-    endActiveNode(): void;
-    ID(): string;
-    activeID(): any;
-    generatedData(): import("./modules/data/DataCollection").DataCollection;
-    trialsOfType(type: any): any;
-    insert(parameters: any): void;
-}
+import { JsPsych } from "./JsPsych";
+export declare class TimelineNode {
+    private jsPsych;
+    relative_id: any;
+    parent_node: any;
+    trial_parameters: any;
+    timeline_parameters: any;
+    node_trial_data: any;
+    progress: any;
+    end_message?: string;
+    constructor(jsPsych: JsPsych, parameters: any, parent?: any, relativeID?: any);
+    trial(): any;
+    markCurrentTrialComplete(): void;
+    nextRepetiton(): void;
+    setTimelineVariablesOrder(): void;
+    nextSet(): void;
+    advance(): any;
+    isComplete(): any;
+    getTimelineVariableValue(variable_name: string): any;
+    findTimelineVariable(variable_name: any): any;
+    timelineVariable(variable_name: string): any;
+    allTimelineVariables(): any;
+    allTimelineVariablesNames(so_far?: any[]): any;
+    length(): number;
+    percentComplete(): number;
+    reset(): void;
+    end(): void;
+    endActiveNode(): void;
+    ID(): string;
+    activeID(): any;
+    generatedData(): import("./modules/data/DataCollection").DataCollection;
+    trialsOfType(type: any): any;
+    insert(parameters: any): void;
+}