clarify nested data types

packages/plugin-copying-task/src/index.js

@@ -164,27 +164,31 @@ var jsPsychCopyingTask = (function (jspsych) {
       },
       /** The contents of the grids as the trial ends. */
       grid_contents: {
-        type: jspsych.ParameterType.COMPLEX, //TODO: specify structure of model/workspace/resource grid contents
+        type: jspsych.ParameterType.COMPLEX,
         nested: {
+          // all are arrays of arrays of strings
           /** The contents of the model grid the participant was to copy. */
           model: {
             type: jspsych.ParameterType.COMPLEX,
+            array: true,
           },
           /** The contents of the workspace grid the participant was to copy the model grid to. */
           workspace: {
             type: jspsych.ParameterType.COMPLEX,
+            array: true,
           },
           /** The contents of the resource grid where participants were given images to drag to the workspace. */
           resource: {
             type: jspsych.ParameterType.COMPLEX,
+            array: true,
           },
         },
       },
       /** An array of objects which each consist of interactions with the resource grid images. */
       trial_events: {
         type: jspsych.ParameterType.COMPLEX,
         array: true,
-        parameters: {
+        nested: {
           /** The type of event the interaction was, split into if the participant successfully or unsuccessfully
            * interacted with the resource grid image, along with if the item was placed correctly or not. */
           event: {
@@ -201,7 +205,17 @@ var jsPsychCopyingTask = (function (jspsych) {
           },
           /** The location on the resource grid that the participant interacted with. */
           grid_coords: {
-            type: jspsych.ParameterType.COMPLEX, //TODO: add "row" and "column" demarkations
+            type: jspsych.ParameterType.COMPLEX,
+            nested: {
+              /** The row of the resource grid the participant interacted with. */
+              row: {
+                type: jspsych.ParameterType.INT,
+              },
+              /** The column of the resource grid the participant interacted with. */
+              column: {
+                type: jspsych.ParameterType.INT,
+              },
+            },
           },
           /** The timestamp of when the interaction occured, in milliseconds measured from when the stimulus appeared. */
           timestamp: {

packages/plugin-corsi-blocks/src/index.ts

@@ -143,25 +143,38 @@ const info = <const>{
     },
   },
   data: {
+    /** The sequence of block indicies that were displayed. */
     sequence: {
       type: ParameterType.INT,
       array: true,
     },
+    /** The sequence of blocks that were selected by the participant. */
     response: {
       type: ParameterType.INT,
       array: true,
     },
+    /** The time, in milliseconds, that the participant took to respond to each block.
+     * These times are cumulative, measured from the onset of the display. */
     rt: {
       type: ParameterType.INT,
       array: true,
     },
+    /** The x and y coordinates of each block that was displayed. */
     blocks: {
       type: ParameterType.COMPLEX,
       array: true,
+      nested: {
+        x: {
+          type: ParameterType.INT,
+        },
+        y: {
+          type: ParameterType.INT,
+        },
+      },
     },
+    /** Whether the participant's response was correct. */
     correct: {
       type: ParameterType.BOOL,
-      default: null,
     },
   },
 };

packages/plugin-gamepad/src/index.ts

@@ -89,6 +89,7 @@ const info = <const>{
     /** The gamepad inputs recorded during the trial. */
     input: {
       type: ParameterType.COMPLEX,
+      array: true,
     },
   },
 };

packages/plugin-html-keyboard-slider/src/index.ts

@@ -14,7 +14,7 @@ const info = <const>{
      * Slider minimum - Note Ints here can also be floats without issue
      */
     min: {
-      type: ParameterType.INT, // BOOL, STRING, INT, FLOAT, FUNCTION, KEY, KEYS, SELECT, HTML_STRING, IMAGE, AUDIO, VIDEO, OBJECT, COMPLEX
+      type: ParameterType.INT,
       default: 0,
     },
     /**

packages/plugin-html-vas-response/index.js

@@ -136,12 +136,22 @@ var jsPsychHtmlVasResponse = (function (jspsych) {
         type: jspsych.ParameterType.STRING,
       },
       /**
-       * A record of the participant's clicks on the scale. Each element in the array is an object with properties `time`
-       * (the time of the click, in milliseconds since the trial began) and `location`
-       * (the location of the click on the VAS, from 0 to 1).
+       * A record of the participant's clicks on the scale. Each element in the array is an object
+       * with properties `time` and `location`.
        */
       clicks: {
         type: jspsych.ParameterType.COMPLEX,
+        array: true,
+        nested: {
+          /** The time of the click, in milliseconds since the trial began. */
+          time: {
+            type: jspsych.ParameterType.INT,
+          },
+          /** The location of the click on the VAS, from 0 to 1. */
+          location: {
+            type: jspsych.ParameterType.FLOAT,
+          },
+        },
       },
     },
   };

packages/plugin-survey-slider/src/index.ts

@@ -1,7 +1,5 @@
 import { JsPsych, JsPsychPlugin, ParameterType, TrialType } from "jspsych";
 
-// BOOL, STRING, INT, FLOAT, FUNCTION, KEY, KEYS, SELECT, HTML_STRING, IMAGE, AUDIO, VIDEO, OBJECT, COMPLEX
-
 const info = <const>{
   name: "survey-slider",
   version: "2.0.0",

packages/plugin-vsl-animate-occlusion/docs/jspsych-vsl-animate-occlusion.md

@@ -32,7 +32,7 @@ In addition to the [default data collected by all plugins](https://www.jspsych.o
 
 | Name      | Type        | Value                                    |
 | --------- | ----------- | ---------------------------------------- |
-| stimulus  | array | Array where each element is a stimulus from the sequence, in the order that they were shown. This will be encoded as a JSON string when data is saved using the `.json()` or `.csv()` functions. |
+| stimuli  | array | Array where each element is a stimulus from the sequence, in the order that they were shown. This will be encoded as a JSON string when data is saved using the `.json()` or `.csv()` functions. |
 | response | array | Array containing all response information. Each element in the array is an object representing each valid response. Each response item has three properties: `key` the key that was pressed, `stimulus` the index of the stimulus that was displayed when the response was made, and `rt` the response time measured since the start of the sequence. This will be encoded as a JSON string when data is saved using the `.json()` or `.csv()` functions. |
 
 ## Examples

packages/plugin-vsl-animate-occlusion/src/index.ts

@@ -66,11 +66,27 @@ const info = <const>{
      *  when data is saved using the `.json()` or `.csv()` functions. */
     response: {
       type: ParameterType.COMPLEX,
+      array: true,
+      nested: {
+        /** The key that was pressed. */
+        key: {
+          type: ParameterType.STRING,
+        },
+        /** The index of the stimulus that was displayed when the response was made. */
+        stimulus: {
+          type: ParameterType.INT,
+        },
+        /** The response time measured since the start of the sequence. */
+        rt: {
+          type: ParameterType.INT,
+        },
+      },
     },
     /** Array where each element is a stimulus from the sequence, in the order that they were shown.
      * This will be encoded as a JSON string when data is saved using the `.json()` or `.csv()` functions. */
-    stimulus: {
-      type: ParameterType.COMPLEX,
+    stimuli: {
+      type: ParameterType.STRING,
+      array: true,
     },
   },
 };