Skip to content

Conversation

@maxine-adn
Copy link

Pull Request: Add vaast-image Plugin

Summary

This PR adds the vaast-image plugin to the repository. This plugin is meant to be used in a VAAST (Visual Approach and Avoidance by the Self Task) experiment. The plugin displays a single trial with an image stimulus appearing on a background image. Participants respond by pressing a key to approach or avoid the image stimulus, as specified by the instructions. The scene changes accordingly.

Features

  • Displays image stimulus on customizable background images
  • Configurable feedback for incorrect responses (e.g., training phase)
  • Supports background images based on position
  • Allows the researcher to force the participant to press the correct key to continue
  • Adjustable stimulus size and trial duration
  • Collects detailed trial data (stimulus, response, correctness, RT, movement, position)

Files Added and Modified

  • packages/plugin-vaast-image/

    • docs/vaast-image.md
    • examples/background/ : contains 3 sets of background images
    • examples/stimuli/ : contains 2 images (square and diamond shapes)
    • examples/minimal_example.html
    • src/index.spec.ts
    • src/index.ts
    • README.md
  • README.md

Checklist

  • The plugin follows jsPsych plugin guidelines.
  • Documentation is complete and clear.
  • Unit tests are provided and passing, see in the src folder: index.spec.ts.
  • Example usage is included, see in the examples folder: minimal_example.html.

Additional Notes

A verification of the contribution's functionality may be accomplished by using the example file and the testing file.
A later PR will consist of the addition of a link to a website, created to help researchers use this plugin (and the two other VAAST plugins) to create VAAST experiments.

@changeset-bot
Copy link

changeset-bot bot commented Aug 20, 2025

⚠️ No Changeset found

Latest commit: 9610861

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

This PR includes no changesets

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

Click here to learn what changesets are, and how to add one.

Click here if you're a maintainer who wants to add a changeset to this PR

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant