@jspsych/plugin-audio-slider-response 1.1.3 → 2.0.1

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","sources":["../src/index.ts"],"sourcesContent":["import { JsPsych, JsPsychPlugin, ParameterType, TrialType } from \"jspsych\";\n\nconst info = <const>{\n  name: \"audio-slider-response\",\n  parameters: {\n    /** The audio file to be played. */\n    stimulus: {\n      type: ParameterType.AUDIO,\n      pretty_name: \"Stimulus\",\n      default: undefined,\n    },\n    /** Sets the minimum value of the slider. */\n    min: {\n      type: ParameterType.INT,\n      pretty_name: \"Min slider\",\n      default: 0,\n    },\n    /** Sets the maximum value of the slider */\n    max: {\n      type: ParameterType.INT,\n      pretty_name: \"Max slider\",\n      default: 100,\n    },\n    /** Sets the starting value of the slider */\n    slider_start: {\n      type: ParameterType.INT,\n      pretty_name: \"Slider starting value\",\n      default: 50,\n    },\n    /** Sets the step of the slider */\n    step: {\n      type: ParameterType.INT,\n      pretty_name: \"Step\",\n      default: 1,\n    },\n    /** Array containing the labels for the slider. Labels will be displayed at equidistant locations along the slider. */\n    labels: {\n      type: ParameterType.HTML_STRING,\n      pretty_name: \"Labels\",\n      default: [],\n      array: true,\n    },\n    /** Width of the slider in pixels. */\n    slider_width: {\n      type: ParameterType.INT,\n      pretty_name: \"Slider width\",\n      default: null,\n    },\n    /** Label of the button to advance. */\n    button_label: {\n      type: ParameterType.STRING,\n      pretty_name: \"Button label\",\n      default: \"Continue\",\n      array: false,\n    },\n    /** If true, the participant will have to move the slider before continuing. */\n    require_movement: {\n      type: ParameterType.BOOL,\n      pretty_name: \"Require movement\",\n      default: false,\n    },\n    /** Any content here will be displayed below the slider. */\n    prompt: {\n      type: ParameterType.HTML_STRING,\n      pretty_name: \"Prompt\",\n      default: null,\n    },\n    /** How long to show the trial. */\n    trial_duration: {\n      type: ParameterType.INT,\n      pretty_name: \"Trial duration\",\n      default: null,\n    },\n    /** If true, trial will end when user makes a response. */\n    response_ends_trial: {\n      type: ParameterType.BOOL,\n      pretty_name: \"Response ends trial\",\n      default: true,\n    },\n    /** If true, then the trial will end as soon as the audio file finishes playing. */\n    trial_ends_after_audio: {\n      type: ParameterType.BOOL,\n      pretty_name: \"Trial ends after audio\",\n      default: false,\n    },\n    /** If true, then responses are allowed while the audio is playing. If false, then the audio must finish playing before a response is accepted. */\n    response_allowed_while_playing: {\n      type: ParameterType.BOOL,\n      pretty_name: \"Response allowed while playing\",\n      default: true,\n    },\n  },\n};\n\ntype Info = typeof info;\n\n/**\n * **audio-slider-response**\n *\n * jsPsych plugin for playing audio and getting a slider response\n *\n * @author Josh de Leeuw\n * @see {@link https://www.jspsych.org/plugins/jspsych-audio-slider-response/ audio-slider-response plugin documentation on jspsych.org}\n */\nclass AudioSliderResponsePlugin implements JsPsychPlugin<Info> {\n  static info = info;\n  private audio;\n\n  constructor(private jsPsych: JsPsych) {}\n\n  trial(display_element: HTMLElement, trial: TrialType<Info>, on_load: () => void) {\n    // hold the .resolve() function from the Promise that ends the trial\n    let trial_complete;\n\n    // half of the thumb width value from jspsych.css, used to adjust the label positions\n    var half_thumb_width = 7.5;\n\n    // setup stimulus\n    var context = this.jsPsych.pluginAPI.audioContext();\n\n    // record webaudio context start time\n    var startTime;\n\n    // for storing data related to response\n    var response;\n\n    // load audio file\n    this.jsPsych.pluginAPI\n      .getAudioBuffer(trial.stimulus)\n      .then((buffer) => {\n        if (context !== null) {\n          this.audio = context.createBufferSource();\n          this.audio.buffer = buffer;\n          this.audio.connect(context.destination);\n        } else {\n          this.audio = buffer;\n          this.audio.currentTime = 0;\n        }\n        setupTrial();\n      })\n      .catch((err) => {\n        console.error(\n          `Failed to load audio file \"${trial.stimulus}\". Try checking the file path. We recommend using the preload plugin to load audio files.`\n        );\n        console.error(err);\n      });\n\n    const setupTrial = () => {\n      // set up end event if trial needs it\n      if (trial.trial_ends_after_audio) {\n        this.audio.addEventListener(\"ended\", end_trial);\n      }\n\n      // enable slider after audio ends if necessary\n      if (!trial.response_allowed_while_playing && !trial.trial_ends_after_audio) {\n        this.audio.addEventListener(\"ended\", enable_slider);\n      }\n\n      var html = '<div id=\"jspsych-audio-slider-response-wrapper\" style=\"margin: 100px 0px;\">';\n      html +=\n        '<div class=\"jspsych-audio-slider-response-container\" style=\"position:relative; margin: 0 auto 3em auto; width:';\n      if (trial.slider_width !== null) {\n        html += trial.slider_width + \"px;\";\n      } else {\n        html += \"auto;\";\n      }\n      html += '\">';\n      html +=\n        '<input type=\"range\" class=\"jspsych-slider\" value=\"' +\n        trial.slider_start +\n        '\" min=\"' +\n        trial.min +\n        '\" max=\"' +\n        trial.max +\n        '\" step=\"' +\n        trial.step +\n        '\" id=\"jspsych-audio-slider-response-response\"';\n      if (!trial.response_allowed_while_playing) {\n        html += \" disabled\";\n      }\n      html += \"></input><div>\";\n      for (var j = 0; j < trial.labels.length; j++) {\n        var label_width_perc = 100 / (trial.labels.length - 1);\n        var percent_of_range = j * (100 / (trial.labels.length - 1));\n        var percent_dist_from_center = ((percent_of_range - 50) / 50) * 100;\n        var offset = (percent_dist_from_center * half_thumb_width) / 100;\n        html +=\n          '<div style=\"border: 1px solid transparent; display: inline-block; position: absolute; ' +\n          \"left:calc(\" +\n          percent_of_range +\n          \"% - (\" +\n          label_width_perc +\n          \"% / 2) - \" +\n          offset +\n          \"px); text-align: center; width: \" +\n          label_width_perc +\n          '%;\">';\n        html += '<span style=\"text-align: center; font-size: 80%;\">' + trial.labels[j] + \"</span>\";\n        html += \"</div>\";\n      }\n      html += \"</div>\";\n      html += \"</div>\";\n      html += \"</div>\";\n\n      if (trial.prompt !== null) {\n        html += trial.prompt;\n      }\n\n      // add submit button\n      var next_disabled_attribute = \"\";\n      if (trial.require_movement || !trial.response_allowed_while_playing) {\n        next_disabled_attribute = \"disabled\";\n      }\n      html +=\n        '<button id=\"jspsych-audio-slider-response-next\" class=\"jspsych-btn\" ' +\n        next_disabled_attribute +\n        \">\" +\n        trial.button_label +\n        \"</button>\";\n\n      display_element.innerHTML = html;\n\n      response = {\n        rt: null,\n        response: null,\n      };\n\n      if (!trial.response_allowed_while_playing) {\n        display_element.querySelector<HTMLInputElement>(\n          \"#jspsych-audio-slider-response-response\"\n        ).disabled = true;\n        display_element.querySelector<HTMLInputElement>(\n          \"#jspsych-audio-slider-response-next\"\n        ).disabled = true;\n      }\n\n      if (trial.require_movement) {\n        const enable_button = () => {\n          display_element.querySelector<HTMLInputElement>(\n            \"#jspsych-audio-slider-response-next\"\n          ).disabled = false;\n        };\n\n        display_element\n          .querySelector(\"#jspsych-audio-slider-response-response\")\n          .addEventListener(\"mousedown\", enable_button);\n\n        display_element\n          .querySelector(\"#jspsych-audio-slider-response-response\")\n          .addEventListener(\"touchstart\", enable_button);\n\n        display_element\n          .querySelector(\"#jspsych-audio-slider-response-response\")\n          .addEventListener(\"change\", enable_button);\n      }\n\n      display_element\n        .querySelector(\"#jspsych-audio-slider-response-next\")\n        .addEventListener(\"click\", () => {\n          // measure response time\n          var endTime = performance.now();\n          var rt = Math.round(endTime - startTime);\n          if (context !== null) {\n            endTime = context.currentTime;\n            rt = Math.round((endTime - startTime) * 1000);\n          }\n          response.rt = rt;\n          response.response = display_element.querySelector<HTMLInputElement>(\n            \"#jspsych-audio-slider-response-response\"\n          ).valueAsNumber;\n\n          if (trial.response_ends_trial) {\n            end_trial();\n          } else {\n            display_element.querySelector<HTMLInputElement>(\n              \"#jspsych-audio-slider-response-next\"\n            ).disabled = true;\n          }\n        });\n\n      startTime = performance.now();\n      // start audio\n      if (context !== null) {\n        startTime = context.currentTime;\n        this.audio.start(startTime);\n      } else {\n        this.audio.play();\n      }\n\n      // end trial if trial_duration is set\n      if (trial.trial_duration !== null) {\n        this.jsPsych.pluginAPI.setTimeout(() => {\n          end_trial();\n        }, trial.trial_duration);\n      }\n\n      on_load();\n    };\n\n    // function to enable slider after audio ends\n    function enable_slider() {\n      document.querySelector<HTMLInputElement>(\"#jspsych-audio-slider-response-response\").disabled =\n        false;\n      if (!trial.require_movement) {\n        document.querySelector<HTMLButtonElement>(\"#jspsych-audio-slider-response-next\").disabled =\n          false;\n      }\n    }\n\n    const end_trial = () => {\n      // kill any remaining setTimeout handlers\n      this.jsPsych.pluginAPI.clearAllTimeouts();\n\n      // stop the audio file if it is playing\n      // remove end event listeners if they exist\n      if (context !== null) {\n        this.audio.stop();\n      } else {\n        this.audio.pause();\n      }\n\n      this.audio.removeEventListener(\"ended\", end_trial);\n      this.audio.removeEventListener(\"ended\", enable_slider);\n\n      // save data\n      var trialdata = {\n        rt: response.rt,\n        stimulus: trial.stimulus,\n        slider_start: trial.slider_start,\n        response: response.response,\n      };\n\n      display_element.innerHTML = \"\";\n\n      // next trial\n      this.jsPsych.finishTrial(trialdata);\n\n      trial_complete();\n    };\n\n    return new Promise((resolve) => {\n      trial_complete = resolve;\n    });\n  }\n\n  simulate(\n    trial: TrialType<Info>,\n    simulation_mode,\n    simulation_options: any,\n    load_callback: () => void\n  ) {\n    if (simulation_mode == \"data-only\") {\n      load_callback();\n      this.simulate_data_only(trial, simulation_options);\n    }\n    if (simulation_mode == \"visual\") {\n      this.simulate_visual(trial, simulation_options, load_callback);\n    }\n  }\n\n  private create_simulation_data(trial: TrialType<Info>, simulation_options) {\n    const default_data = {\n      stimulus: trial.stimulus,\n      slider_start: trial.slider_start,\n      response: this.jsPsych.randomization.randomInt(trial.min, trial.max),\n      rt: this.jsPsych.randomization.sampleExGaussian(500, 50, 1 / 150, true),\n    };\n\n    const data = this.jsPsych.pluginAPI.mergeSimulationData(default_data, simulation_options);\n\n    this.jsPsych.pluginAPI.ensureSimulationDataConsistency(trial, data);\n\n    return data;\n  }\n\n  private simulate_data_only(trial: TrialType<Info>, simulation_options) {\n    const data = this.create_simulation_data(trial, simulation_options);\n\n    this.jsPsych.finishTrial(data);\n  }\n\n  private simulate_visual(trial: TrialType<Info>, simulation_options, load_callback: () => void) {\n    const data = this.create_simulation_data(trial, simulation_options);\n\n    const display_element = this.jsPsych.getDisplayElement();\n\n    const respond = () => {\n      if (data.rt !== null) {\n        const el = display_element.querySelector<HTMLInputElement>(\"input[type='range']\");\n\n        setTimeout(() => {\n          this.jsPsych.pluginAPI.clickTarget(el);\n          el.valueAsNumber = data.response;\n        }, data.rt / 2);\n\n        this.jsPsych.pluginAPI.clickTarget(display_element.querySelector(\"button\"), data.rt);\n      }\n    };\n\n    this.trial(display_element, trial, () => {\n      load_callback();\n\n      if (!trial.response_allowed_while_playing) {\n        this.audio.addEventListener(\"ended\", respond);\n      } else {\n        respond();\n      }\n    });\n  }\n}\n\nexport default AudioSliderResponsePlugin;\n"],"names":["ParameterType"],"mappings":"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"}
+{"version":3,"file":"index.cjs","sources":["../src/index.ts"],"sourcesContent":["import autoBind from \"auto-bind\";\nimport { JsPsych, JsPsychPlugin, ParameterType, TrialType } from \"jspsych\";\n\nimport { AudioPlayerInterface } from \"../../jspsych/src/modules/plugin-api/AudioPlayer\";\nimport { version } from \"../package.json\";\n\nconst info = <const>{\n  name: \"audio-slider-response\",\n  version: version,\n  parameters: {\n    /** Audio file to be played. */\n    stimulus: {\n      type: ParameterType.AUDIO,\n      default: undefined,\n    },\n    /** Sets the minimum value of the slider. */\n    min: {\n      type: ParameterType.INT,\n      default: 0,\n    },\n    /** Sets the maximum value of the slider */\n    max: {\n      type: ParameterType.INT,\n      default: 100,\n    },\n    /** Sets the starting value of the slider */\n    slider_start: {\n      type: ParameterType.INT,\n      default: 50,\n    },\n    /** Sets the step of the slider. This is the smallest amount by which the slider can change. */\n    step: {\n      type: ParameterType.INT,\n      default: 1,\n    },\n    /** Labels displayed at equidistant locations on the slider. For example, two labels will be placed at the ends of the\n     * slider. Three labels would place two at the ends and one in the middle. Four will place two at the ends, and the\n     * other two will be at 33% and 67% of the slider width.\n     */\n    labels: {\n      type: ParameterType.HTML_STRING,\n      default: [],\n      array: true,\n    },\n    /** Set the width of the slider in pixels. If left null, then the width will be equal to the widest element in the display. */\n    slider_width: {\n      type: ParameterType.INT,\n      default: null,\n    },\n    /** Label of the button to end the trial. */\n    button_label: {\n      type: ParameterType.STRING,\n      default: \"Continue\",\n      array: false,\n    },\n    /** If true, the participant must move the slider before clicking the continue button. */\n    require_movement: {\n      type: ParameterType.BOOL,\n      default: false,\n    },\n    /** This string can contain HTML markup. Any content here will be displayed below the stimulus. The intention is\n     * that it can be used to provide a reminder about the action the participant is supposed to take (e.g., which key to press).\n     */\n    prompt: {\n      type: ParameterType.HTML_STRING,\n      default: null,\n    },\n    /** How long to wait for the participant to make a response before ending the trial in milliseconds. If\n     * the participant fails to make a response before this timer is reached, the participant's response will be\n     * recorded as null for the trial and the trial will end. If the value of this parameter is null, then the trial\n     * will wait for a response indefinitely.\n     */\n    trial_duration: {\n      type: ParameterType.INT,\n      default: null,\n    },\n    /** If true, then the trial will end whenever the participant makes a response (assuming they make their response\n     * before the cutoff specified by the `trial_duration` parameter). If false, then the trial will continue until the\n     * value for `trial_duration` is reached. You can set this parameter to `false` to force the participant to listen to\n     * the stimulus for a fixed amount of time, even if they respond before the time is complete.\n     */\n    response_ends_trial: {\n      type: ParameterType.BOOL,\n      default: true,\n    },\n    /** If true, then the trial will end as soon as the audio file finishes playing. */\n    trial_ends_after_audio: {\n      type: ParameterType.BOOL,\n      default: false,\n    },\n    /** If true, then responses are allowed while the audio is playing. If false, then the audio must finish playing before\n     * the slider is enabled and the trial can end via the next button click. Once the audio has played all the way through,\n     * the slider is enabled and a response is allowed (including while the audio is being re-played via on-screen playback controls).\n     */\n    response_allowed_while_playing: {\n      type: ParameterType.BOOL,\n      default: true,\n    },\n  },\n  data: {\n    /** The numeric value of the slider. */\n    response: {\n      type: ParameterType.INT,\n    },\n    /** The time in milliseconds for the participant to make a response. The time is measured from when the stimulus first\n     * began playing until the participant's response.\n     */\n    rt: {\n      type: ParameterType.INT,\n    },\n    /** The path of the audio file that was played. */\n    stimulus: {\n      type: ParameterType.STRING,\n    },\n    /** The starting value of the slider. */\n    slider_start: {\n      type: ParameterType.INT,\n    },\n  },\n};\n\ntype Info = typeof info;\n\n/**\n * This plugin plays an audio file and allows the participant to respond by dragging a slider.\n *\n * If the browser supports it, audio files are played using the WebAudio API. This allows for reasonably precise timing of the\n * playback. The timing of responses generated is measured against the WebAudio specific clock, improving the measurement of\n * response times. If the browser does not support the WebAudio API, then the audio file is played with HTML5 audio.\n *\n * Audio files can be automatically preloaded by jsPsych using the [`preload` plugin](preload.md). However, if you are using\n * timeline variables or another dynamic method to specify the audio stimulus, then you will need\n * to [manually preload](../overview/media-preloading.md#manual-preloading) the audio.\n *\n * The trial can end when the participant responds, or if the participant has failed to respond within a fixed length of time. You can also prevent the slider response from being made before the audio has finished playing.\n * @author Josh de Leeuw\n * @see {@link https://www.jspsych.org/latest/plugins/audio-slider-response/ audio-slider-response plugin documentation on jspsych.org}\n */\nclass AudioSliderResponsePlugin implements JsPsychPlugin<Info> {\n  static info = info;\n  private audio: AudioPlayerInterface;\n  private context: AudioContext;\n  private params: TrialType<Info>;\n  private display: HTMLElement;\n  private response: { rt: number; response: number } = { rt: null, response: null };\n  private startTime: number;\n  private half_thumb_width: number;\n  private trial_complete: (trial_data: {\n    rt: number;\n    slider_start: number;\n    response: number;\n  }) => void;\n\n  constructor(private jsPsych: JsPsych) {\n    autoBind(this);\n  }\n\n  async trial(display_element: HTMLElement, trial: TrialType<Info>, on_load: () => void) {\n    this.params = trial;\n    this.display = display_element;\n    // for storing data related to response\n    this.response;\n    // half of the thumb width value from jspsych.css, used to adjust the label positions\n    this.half_thumb_width = 7.5;\n    // hold the .resolve() function from the Promise that ends the trial\n    this.trial_complete;\n\n    // setup stimulus\n    this.context = this.jsPsych.pluginAPI.audioContext();\n\n    // load audio file\n    this.audio = await this.jsPsych.pluginAPI.getAudioPlayer(trial.stimulus);\n\n    this.setupTrial();\n\n    on_load();\n\n    return new Promise((resolve) => {\n      this.trial_complete = resolve;\n    });\n  }\n\n  // to enable slider after audio ends\n  private enable_slider() {\n    document.querySelector<HTMLInputElement>(\"#jspsych-audio-slider-response-response\").disabled =\n      false;\n    if (!this.params.require_movement) {\n      document.querySelector<HTMLButtonElement>(\"#jspsych-audio-slider-response-next\").disabled =\n        false;\n    }\n  }\n\n  private setupTrial = () => {\n    // set up end event if trial needs it\n    if (this.params.trial_ends_after_audio) {\n      this.audio.addEventListener(\"ended\", this.end_trial);\n    }\n\n    // enable slider after audio ends if necessary\n    if (!this.params.response_allowed_while_playing && !this.params.trial_ends_after_audio) {\n      this.audio.addEventListener(\"ended\", this.enable_slider);\n    }\n\n    var html = '<div id=\"jspsych-audio-slider-response-wrapper\" style=\"margin: 100px 0px;\">';\n    html +=\n      '<div class=\"jspsych-audio-slider-response-container\" style=\"position:relative; margin: 0 auto 3em auto; width:';\n    if (this.params.slider_width !== null) {\n      html += this.params.slider_width + \"px;\";\n    } else {\n      html += \"auto;\";\n    }\n    html += '\">';\n    html +=\n      '<input type=\"range\" class=\"jspsych-slider\" value=\"' +\n      this.params.slider_start +\n      '\" min=\"' +\n      this.params.min +\n      '\" max=\"' +\n      this.params.max +\n      '\" step=\"' +\n      this.params.step +\n      '\" id=\"jspsych-audio-slider-response-response\"';\n    if (!this.params.response_allowed_while_playing) {\n      html += \" disabled\";\n    }\n    html += \"></input><div>\";\n    for (var j = 0; j < this.params.labels.length; j++) {\n      var label_width_perc = 100 / (this.params.labels.length - 1);\n      var percent_of_range = j * (100 / (this.params.labels.length - 1));\n      var percent_dist_from_center = ((percent_of_range - 50) / 50) * 100;\n      var offset = (percent_dist_from_center * this.half_thumb_width) / 100;\n      html +=\n        '<div style=\"border: 1px solid transparent; display: inline-block; position: absolute; ' +\n        \"left:calc(\" +\n        percent_of_range +\n        \"% - (\" +\n        label_width_perc +\n        \"% / 2) - \" +\n        offset +\n        \"px); text-align: center; width: \" +\n        label_width_perc +\n        '%;\">';\n      html +=\n        '<span style=\"text-align: center; font-size: 80%;\">' + this.params.labels[j] + \"</span>\";\n      html += \"</div>\";\n    }\n    html += \"</div>\";\n    html += \"</div>\";\n    html += \"</div>\";\n\n    if (this.params.prompt !== null) {\n      html += this.params.prompt;\n    }\n\n    // add submit button\n    var next_disabled_attribute = \"\";\n    if (this.params.require_movement || !this.params.response_allowed_while_playing) {\n      next_disabled_attribute = \"disabled\";\n    }\n    html +=\n      '<button id=\"jspsych-audio-slider-response-next\" class=\"jspsych-btn\" ' +\n      next_disabled_attribute +\n      \">\" +\n      this.params.button_label +\n      \"</button>\";\n\n    this.display.innerHTML = html;\n\n    this.response = {\n      rt: null,\n      response: null,\n    };\n\n    if (!this.params.response_allowed_while_playing) {\n      this.display.querySelector<HTMLInputElement>(\n        \"#jspsych-audio-slider-response-response\"\n      ).disabled = true;\n      this.display.querySelector<HTMLInputElement>(\"#jspsych-audio-slider-response-next\").disabled =\n        true;\n    }\n\n    if (this.params.require_movement) {\n      const enable_button = () => {\n        this.display.querySelector<HTMLInputElement>(\n          \"#jspsych-audio-slider-response-next\"\n        ).disabled = false;\n      };\n\n      this.display\n        .querySelector(\"#jspsych-audio-slider-response-response\")\n        .addEventListener(\"mousedown\", enable_button);\n\n      this.display\n        .querySelector(\"#jspsych-audio-slider-response-response\")\n        .addEventListener(\"touchstart\", enable_button);\n\n      this.display\n        .querySelector(\"#jspsych-audio-slider-response-response\")\n        .addEventListener(\"change\", enable_button);\n    }\n\n    this.display\n      .querySelector(\"#jspsych-audio-slider-response-next\")\n      .addEventListener(\"click\", () => {\n        // measure response time\n        var endTime = performance.now();\n        var rt = Math.round(endTime - this.startTime);\n        if (this.context !== null) {\n          endTime = this.context.currentTime;\n          rt = Math.round((endTime - this.startTime) * 1000);\n        }\n        this.response.rt = rt;\n        this.response.response = this.display.querySelector<HTMLInputElement>(\n          \"#jspsych-audio-slider-response-response\"\n        ).valueAsNumber;\n\n        if (this.params.response_ends_trial) {\n          this.end_trial();\n        } else {\n          this.display.querySelector<HTMLInputElement>(\n            \"#jspsych-audio-slider-response-next\"\n          ).disabled = true;\n        }\n      });\n\n    //record start time\n    this.startTime = performance.now();\n    // record webaudio context start time\n    if (this.context !== null) {\n      this.startTime = this.context.currentTime;\n    }\n\n    // start audio\n    this.audio.play();\n\n    // end trial if trial_duration is set\n    if (this.params.trial_duration !== null) {\n      this.jsPsych.pluginAPI.setTimeout(() => {\n        this.end_trial();\n      }, this.params.trial_duration);\n    }\n  };\n\n  private end_trial = () => {\n    // kill any remaining setTimeout handlers\n    this.jsPsych.pluginAPI.clearAllTimeouts();\n\n    // stop the audio file if it is playing\n    this.audio.stop();\n\n    // remove end event listeners if they exist\n    this.audio.removeEventListener(\"ended\", this.end_trial);\n    this.audio.removeEventListener(\"ended\", this.enable_slider);\n\n    // save data\n    var trialdata = {\n      rt: this.response.rt,\n      stimulus: this.params.stimulus,\n      slider_start: this.params.slider_start,\n      response: this.response.response,\n    };\n\n    this.display.innerHTML = \"\";\n\n    // next trial\n    this.trial_complete(trialdata);\n  };\n\n  simulate(\n    trial: TrialType<Info>,\n    simulation_mode,\n    simulation_options: any,\n    load_callback: () => void\n  ) {\n    if (simulation_mode == \"data-only\") {\n      load_callback();\n      this.simulate_data_only(trial, simulation_options);\n    }\n    if (simulation_mode == \"visual\") {\n      this.simulate_visual(trial, simulation_options, load_callback);\n    }\n  }\n\n  private create_simulation_data(trial: TrialType<Info>, simulation_options) {\n    const default_data = {\n      stimulus: trial.stimulus,\n      slider_start: trial.slider_start,\n      response: this.jsPsych.randomization.randomInt(trial.min, trial.max),\n      rt: this.jsPsych.randomization.sampleExGaussian(500, 50, 1 / 150, true),\n    };\n\n    const data = this.jsPsych.pluginAPI.mergeSimulationData(default_data, simulation_options);\n\n    this.jsPsych.pluginAPI.ensureSimulationDataConsistency(trial, data);\n\n    return data;\n  }\n\n  private simulate_data_only(trial: TrialType<Info>, simulation_options) {\n    const data = this.create_simulation_data(trial, simulation_options);\n\n    this.jsPsych.finishTrial(data);\n  }\n\n  private simulate_visual(trial: TrialType<Info>, simulation_options, load_callback: () => void) {\n    const data = this.create_simulation_data(trial, simulation_options);\n\n    const display_element = this.jsPsych.getDisplayElement();\n\n    const respond = () => {\n      if (data.rt !== null) {\n        const el = display_element.querySelector<HTMLInputElement>(\"input[type='range']\");\n\n        setTimeout(() => {\n          this.jsPsych.pluginAPI.clickTarget(el);\n          el.valueAsNumber = data.response;\n        }, data.rt / 2);\n\n        this.jsPsych.pluginAPI.clickTarget(display_element.querySelector(\"button\"), data.rt);\n      }\n    };\n\n    this.trial(display_element, trial, () => {\n      load_callback();\n\n      if (!trial.response_allowed_while_playing) {\n        this.audio.addEventListener(\"ended\", respond);\n      } else {\n        respond();\n      }\n    });\n  }\n}\n\nexport default AudioSliderResponsePlugin;\n"],"names":["version","ParameterType"],"mappings":"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"}

package/dist/index.d.ts

@@ -1,203 +1,268 @@
-import { JsPsych, JsPsychPlugin, ParameterType, TrialType } from "jspsych";
+import { JsPsychPlugin, ParameterType, JsPsych, TrialType } from 'jspsych';
+
 declare const info: {
     readonly name: "audio-slider-response";
+    readonly version: string;
     readonly parameters: {
-        /** The audio file to be played. */
+        /** Audio file to be played. */
         readonly stimulus: {
             readonly type: ParameterType.AUDIO;
-            readonly pretty_name: "Stimulus";
             readonly default: any;
         };
         /** Sets the minimum value of the slider. */
         readonly min: {
             readonly type: ParameterType.INT;
-            readonly pretty_name: "Min slider";
             readonly default: 0;
         };
         /** Sets the maximum value of the slider */
         readonly max: {
             readonly type: ParameterType.INT;
-            readonly pretty_name: "Max slider";
             readonly default: 100;
         };
         /** Sets the starting value of the slider */
         readonly slider_start: {
             readonly type: ParameterType.INT;
-            readonly pretty_name: "Slider starting value";
             readonly default: 50;
         };
-        /** Sets the step of the slider */
+        /** Sets the step of the slider. This is the smallest amount by which the slider can change. */
         readonly step: {
             readonly type: ParameterType.INT;
-            readonly pretty_name: "Step";
             readonly default: 1;
         };
-        /** Array containing the labels for the slider. Labels will be displayed at equidistant locations along the slider. */
+        /** Labels displayed at equidistant locations on the slider. For example, two labels will be placed at the ends of the
+         * slider. Three labels would place two at the ends and one in the middle. Four will place two at the ends, and the
+         * other two will be at 33% and 67% of the slider width.
+         */
         readonly labels: {
             readonly type: ParameterType.HTML_STRING;
-            readonly pretty_name: "Labels";
             readonly default: readonly [];
             readonly array: true;
         };
-        /** Width of the slider in pixels. */
+        /** Set the width of the slider in pixels. If left null, then the width will be equal to the widest element in the display. */
         readonly slider_width: {
             readonly type: ParameterType.INT;
-            readonly pretty_name: "Slider width";
             readonly default: any;
         };
-        /** Label of the button to advance. */
+        /** Label of the button to end the trial. */
         readonly button_label: {
             readonly type: ParameterType.STRING;
-            readonly pretty_name: "Button label";
             readonly default: "Continue";
             readonly array: false;
         };
-        /** If true, the participant will have to move the slider before continuing. */
+        /** If true, the participant must move the slider before clicking the continue button. */
         readonly require_movement: {
             readonly type: ParameterType.BOOL;
-            readonly pretty_name: "Require movement";
             readonly default: false;
         };
-        /** Any content here will be displayed below the slider. */
+        /** This string can contain HTML markup. Any content here will be displayed below the stimulus. The intention is
+         * that it can be used to provide a reminder about the action the participant is supposed to take (e.g., which key to press).
+         */
         readonly prompt: {
             readonly type: ParameterType.HTML_STRING;
-            readonly pretty_name: "Prompt";
             readonly default: any;
         };
-        /** How long to show the trial. */
+        /** How long to wait for the participant to make a response before ending the trial in milliseconds. If
+         * the participant fails to make a response before this timer is reached, the participant's response will be
+         * recorded as null for the trial and the trial will end. If the value of this parameter is null, then the trial
+         * will wait for a response indefinitely.
+         */
         readonly trial_duration: {
             readonly type: ParameterType.INT;
-            readonly pretty_name: "Trial duration";
             readonly default: any;
         };
-        /** If true, trial will end when user makes a response. */
+        /** If true, then the trial will end whenever the participant makes a response (assuming they make their response
+         * before the cutoff specified by the `trial_duration` parameter). If false, then the trial will continue until the
+         * value for `trial_duration` is reached. You can set this parameter to `false` to force the participant to listen to
+         * the stimulus for a fixed amount of time, even if they respond before the time is complete.
+         */
         readonly response_ends_trial: {
             readonly type: ParameterType.BOOL;
-            readonly pretty_name: "Response ends trial";
             readonly default: true;
         };
         /** If true, then the trial will end as soon as the audio file finishes playing. */
         readonly trial_ends_after_audio: {
             readonly type: ParameterType.BOOL;
-            readonly pretty_name: "Trial ends after audio";
             readonly default: false;
         };
-        /** If true, then responses are allowed while the audio is playing. If false, then the audio must finish playing before a response is accepted. */
+        /** If true, then responses are allowed while the audio is playing. If false, then the audio must finish playing before
+         * the slider is enabled and the trial can end via the next button click. Once the audio has played all the way through,
+         * the slider is enabled and a response is allowed (including while the audio is being re-played via on-screen playback controls).
+         */
         readonly response_allowed_while_playing: {
             readonly type: ParameterType.BOOL;
-            readonly pretty_name: "Response allowed while playing";
             readonly default: true;
         };
     };
+    readonly data: {
+        /** The numeric value of the slider. */
+        readonly response: {
+            readonly type: ParameterType.INT;
+        };
+        /** The time in milliseconds for the participant to make a response. The time is measured from when the stimulus first
+         * began playing until the participant's response.
+         */
+        readonly rt: {
+            readonly type: ParameterType.INT;
+        };
+        /** The path of the audio file that was played. */
+        readonly stimulus: {
+            readonly type: ParameterType.STRING;
+        };
+        /** The starting value of the slider. */
+        readonly slider_start: {
+            readonly type: ParameterType.INT;
+        };
+    };
 };
 type Info = typeof info;
 /**
- * **audio-slider-response**
+ * This plugin plays an audio file and allows the participant to respond by dragging a slider.
+ *
+ * If the browser supports it, audio files are played using the WebAudio API. This allows for reasonably precise timing of the
+ * playback. The timing of responses generated is measured against the WebAudio specific clock, improving the measurement of
+ * response times. If the browser does not support the WebAudio API, then the audio file is played with HTML5 audio.
  *
- * jsPsych plugin for playing audio and getting a slider response
+ * Audio files can be automatically preloaded by jsPsych using the [`preload` plugin](preload.md). However, if you are using
+ * timeline variables or another dynamic method to specify the audio stimulus, then you will need
+ * to [manually preload](../overview/media-preloading.md#manual-preloading) the audio.
  *
+ * The trial can end when the participant responds, or if the participant has failed to respond within a fixed length of time. You can also prevent the slider response from being made before the audio has finished playing.
  * @author Josh de Leeuw
- * @see {@link https://www.jspsych.org/plugins/jspsych-audio-slider-response/ audio-slider-response plugin documentation on jspsych.org}
+ * @see {@link https://www.jspsych.org/latest/plugins/audio-slider-response/ audio-slider-response plugin documentation on jspsych.org}
  */
 declare class AudioSliderResponsePlugin implements JsPsychPlugin<Info> {
     private jsPsych;
     static info: {
         readonly name: "audio-slider-response";
+        readonly version: string;
         readonly parameters: {
-            /** The audio file to be played. */
+            /** Audio file to be played. */
             readonly stimulus: {
                 readonly type: ParameterType.AUDIO;
-                readonly pretty_name: "Stimulus";
                 readonly default: any;
             };
             /** Sets the minimum value of the slider. */
             readonly min: {
                 readonly type: ParameterType.INT;
-                readonly pretty_name: "Min slider";
                 readonly default: 0;
             };
             /** Sets the maximum value of the slider */
             readonly max: {
                 readonly type: ParameterType.INT;
-                readonly pretty_name: "Max slider";
                 readonly default: 100;
             };
             /** Sets the starting value of the slider */
             readonly slider_start: {
                 readonly type: ParameterType.INT;
-                readonly pretty_name: "Slider starting value";
                 readonly default: 50;
             };
-            /** Sets the step of the slider */
+            /** Sets the step of the slider. This is the smallest amount by which the slider can change. */
             readonly step: {
                 readonly type: ParameterType.INT;
-                readonly pretty_name: "Step";
                 readonly default: 1;
             };
-            /** Array containing the labels for the slider. Labels will be displayed at equidistant locations along the slider. */
+            /** Labels displayed at equidistant locations on the slider. For example, two labels will be placed at the ends of the
+             * slider. Three labels would place two at the ends and one in the middle. Four will place two at the ends, and the
+             * other two will be at 33% and 67% of the slider width.
+             */
             readonly labels: {
                 readonly type: ParameterType.HTML_STRING;
-                readonly pretty_name: "Labels";
                 readonly default: readonly [];
                 readonly array: true;
             };
-            /** Width of the slider in pixels. */
+            /** Set the width of the slider in pixels. If left null, then the width will be equal to the widest element in the display. */
             readonly slider_width: {
                 readonly type: ParameterType.INT;
-                readonly pretty_name: "Slider width";
                 readonly default: any;
             };
-            /** Label of the button to advance. */
+            /** Label of the button to end the trial. */
             readonly button_label: {
                 readonly type: ParameterType.STRING;
-                readonly pretty_name: "Button label";
                 readonly default: "Continue";
                 readonly array: false;
             };
-            /** If true, the participant will have to move the slider before continuing. */
+            /** If true, the participant must move the slider before clicking the continue button. */
             readonly require_movement: {
                 readonly type: ParameterType.BOOL;
-                readonly pretty_name: "Require movement";
                 readonly default: false;
             };
-            /** Any content here will be displayed below the slider. */
+            /** This string can contain HTML markup. Any content here will be displayed below the stimulus. The intention is
+             * that it can be used to provide a reminder about the action the participant is supposed to take (e.g., which key to press).
+             */
             readonly prompt: {
                 readonly type: ParameterType.HTML_STRING;
-                readonly pretty_name: "Prompt";
                 readonly default: any;
             };
-            /** How long to show the trial. */
+            /** How long to wait for the participant to make a response before ending the trial in milliseconds. If
+             * the participant fails to make a response before this timer is reached, the participant's response will be
+             * recorded as null for the trial and the trial will end. If the value of this parameter is null, then the trial
+             * will wait for a response indefinitely.
+             */
             readonly trial_duration: {
                 readonly type: ParameterType.INT;
-                readonly pretty_name: "Trial duration";
                 readonly default: any;
             };
-            /** If true, trial will end when user makes a response. */
+            /** If true, then the trial will end whenever the participant makes a response (assuming they make their response
+             * before the cutoff specified by the `trial_duration` parameter). If false, then the trial will continue until the
+             * value for `trial_duration` is reached. You can set this parameter to `false` to force the participant to listen to
+             * the stimulus for a fixed amount of time, even if they respond before the time is complete.
+             */
             readonly response_ends_trial: {
                 readonly type: ParameterType.BOOL;
-                readonly pretty_name: "Response ends trial";
                 readonly default: true;
             };
             /** If true, then the trial will end as soon as the audio file finishes playing. */
             readonly trial_ends_after_audio: {
                 readonly type: ParameterType.BOOL;
-                readonly pretty_name: "Trial ends after audio";
                 readonly default: false;
             };
-            /** If true, then responses are allowed while the audio is playing. If false, then the audio must finish playing before a response is accepted. */
+            /** If true, then responses are allowed while the audio is playing. If false, then the audio must finish playing before
+             * the slider is enabled and the trial can end via the next button click. Once the audio has played all the way through,
+             * the slider is enabled and a response is allowed (including while the audio is being re-played via on-screen playback controls).
+             */
             readonly response_allowed_while_playing: {
                 readonly type: ParameterType.BOOL;
-                readonly pretty_name: "Response allowed while playing";
                 readonly default: true;
             };
         };
+        readonly data: {
+            /** The numeric value of the slider. */
+            readonly response: {
+                readonly type: ParameterType.INT;
+            };
+            /** The time in milliseconds for the participant to make a response. The time is measured from when the stimulus first
+             * began playing until the participant's response.
+             */
+            readonly rt: {
+                readonly type: ParameterType.INT;
+            };
+            /** The path of the audio file that was played. */
+            readonly stimulus: {
+                readonly type: ParameterType.STRING;
+            };
+            /** The starting value of the slider. */
+            readonly slider_start: {
+                readonly type: ParameterType.INT;
+            };
+        };
     };
     private audio;
+    private context;
+    private params;
+    private display;
+    private response;
+    private startTime;
+    private half_thumb_width;
+    private trial_complete;
     constructor(jsPsych: JsPsych);
     trial(display_element: HTMLElement, trial: TrialType<Info>, on_load: () => void): Promise<unknown>;
+    private enable_slider;
+    private setupTrial;
+    private end_trial;
     simulate(trial: TrialType<Info>, simulation_mode: any, simulation_options: any, load_callback: () => void): void;
     private create_simulation_data;
     private simulate_data_only;
     private simulate_visual;
 }
-export default AudioSliderResponsePlugin;
+
+export { AudioSliderResponsePlugin as default };