@decidables/accumulable-elements 0.1.3 → 0.2.1

package/CHANGELOG.md

@@ -3,6 +3,34 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+## [0.2.1](https://github.com/decidables/decidables/compare/@decidables/accumulable-elements@0.2.0...@decidables/accumulable-elements@0.2.1) (2025-09-09)
+
+**Note:** Version bump only for package @decidables/accumulable-elements
+
+
+
+
+
+## [0.2.0](https://github.com/decidables/decidables/compare/@decidables/accumulable-elements@0.1.3...@decidables/accumulable-elements@0.2.0) (2025-05-20)
+
+
+### Features
+
+* **accumulable-elements:** add colored sliders to ddm-parameters ([eba01e5](https://github.com/decidables/decidables/commit/eba01e57279ac5df06f619a0f63e34c16e856656))
+* **accumulable-elements:** controls/parameters must be explicitly included to be shown in examples ([1dc025d](https://github.com/decidables/decidables/commit/1dc025d0919e8249f8447a5608a81d515e22ec08))
+* **accumulable-elements:** human example now has attributes shared to slotted children ([eb25a21](https://github.com/decidables/decidables/commit/eb25a21db6972731e4fec184ac7ff98c403e7d75))
+* **accumulable-elements:** use new parameter settings in DDMMath ([95ce71f](https://github.com/decidables/decidables/commit/95ce71fc6337ba0af73154135f3381d2092ca1e5))
+
+
+### Bug Fixes
+
+* **accumulable-elements:** add proper touch targets in ddm-model ([bb808d6](https://github.com/decidables/decidables/commit/bb808d6f5afc9ce78297f14071e9faab7634b205))
+* **accumulable-elements:** better target touch adjustments ([969aa65](https://github.com/decidables/decidables/commit/969aa65896a0fef1e0503b5e082db2f1ff740114))
+* **accumulable-elements:** clean-up examples to consistently handle events ([d6964d9](https://github.com/decidables/decidables/commit/d6964d91f692961323ccaa57dc6145f5b6aa9fa9))
+* **accumulable-elements:** tweak touch targets for ddm-model ([6bd2dd7](https://github.com/decidables/decidables/commit/6bd2dd73add80ba898d956b0042a02fd71509ed8))
+
+
+
 ## [0.1.3](https://github.com/decidables/decidables/compare/@decidables/accumulable-elements@0.1.2...@decidables/accumulable-elements@0.1.3) (2025-02-06)
 
 **Note:** Version bump only for package @decidables/accumulable-elements

package/README.md

@@ -126,6 +126,9 @@ Response buttons, feedback, and payoffs for two-alternative forced choice tasks
 This element provides 'left' and 'right' response buttons. It can also display a running count of
 the trials, display feedback on accuracy, and display the current trial and total payoff.
 
+Also accepts keyboard responses: <kbd>ArrowLeft</kbd> for 'left' button and <kbd>ArrowRight</kbd> for
+'right' button.
+
 ##### Attributes
 
 - `interactive: boolean = false`
@@ -191,28 +194,29 @@ the trials, display feedback on accuracy, and display the current trial and tota
       - The outcome of the trial as an `'error'` or `'correct'`
     - `payoff: number`
       - The payoff for this trial
-    - `correctCount: number`
-      - Number of correct trials
-    - `errorCount: number`
-      - Number of error trials
-    - `nrCount: number`
-      - Number of no-response trials
-    - `accuracy: number`
-      - Proportion of correct trials
-    - `meanRT: number`
-      - Overall mean reaction time
-    - `correctMeanRT: number`
-      - Mean reaction time on correct trials
-    - `errorMeanRT: number`
-      - Mean reaction time on error trials
-    - `sdRT: number`
-      - Overall standard deviation of reaction time
-    - `correctSDRT: number`
-      - Standard deviation of reaction time on correct trials
-    - `errorSDRT: number`
-      - Standard deviation of reaction time on error trials
     - `totalPayoff: number`
       - Total payoff for the block
+    - `data: object`
+      - `correctCount: number`
+        - Number of correct trials
+      - `errorCount: number`
+        - Number of error trials
+      - `nrCount: number`
+        - Number of no-response trials
+      - `accuracy: number`
+        - Proportion of correct trials
+      - `meanRT: number`
+        - Overall mean reaction time
+      - `correctMeanRT: number`
+        - Mean reaction time on correct trials
+      - `errorMeanRT: number`
+        - Mean reaction time on error trials
+      - `sdRT: number`
+        - Overall standard deviation of reaction time
+      - `correctSDRT: number`
+        - Standard deviation of reaction time on correct trials
+      - `errorSDRT: number`
+        - Standard deviation of reaction time on error trials
 
 ##### Example
 
@@ -565,23 +569,23 @@ The paths can be animated when added individually to the visualization.
 Control panel for DDM model parameters
 
 A configurable set of controls for user manipulation of DDM model parameters. Controls can be
-provided for the boundary separation, starting pointm, drift rate, and non-decision time.
+provided for the boundary separation, starting point, drift rate, and non-decision time.
 
 ##### Attributes
 
-- `a: number = undefined`
+- `boundary-separation: number = undefined`
   - Show a slider for setting the boundary separation, initialized to the value provided
   - Options
     - `0.01` to `2` in steps of `0.01`
-- `z: number = undefined`
+- `starting-point: number = undefined`
   - Show a slider for setting the starting point, initialized to the value provided
   - Options
     - `0.01` to `0.99` in steps of `0.01`
-- `z: number = undefined`
+- `drift-rate: number = undefined`
   - Show a slider for setting the drift rate, initialized to the value provided
   - Options
     - `0.01` to `5` in steps of `0.01`
-- `t0: number = undefined`
+- `nondecision-time: number = undefined`
   - Show a slider for setting the non-decision time, initialized to the value provided
   - Options
     - `0` to `500` in steps of `1`
@@ -817,6 +821,30 @@ space, and a visual rendering of signal detection theory. The table of results,
 SDT model should not be interactive, because their values are received from the user's task
 performance.
 
+##### Attributes
+
+**Note:** Since model parameter attributes are set on the example, they don't need to be set on the
+individual components, as they will be propagated and kept in sync.
+
+- `trials: number = 10`
+  - Number of sampled trials to display
+- `duration: number = 2000`
+  - The duration of the stimulus, wait, and inter-trial interval on each trial, initialized to the
+    value provided in milliseconds
+- `coherence: number = 0.5`
+  - The proportion of coherent dots in the visual stimulus
+- `color: string = outcome`
+  - How to color the cells in the results table
+  - Options
+    - `'none'`
+      - No use of color
+    - `'measure'`
+      - Color based on measure (*count/accuracy*, *mean RT*, *standard deviation RT*)
+    - `'outcome'`
+      - Color based on outcome (*correct*, *error*, *overall*)
+    - `'all'`
+      - Color based on measure and outcome
+
 ##### Slots
 
 - *unnamed*
@@ -840,11 +868,11 @@ performance.
 ##### Example
 
 ```html
-<ddm-example-human>
-  <accumulable-control trials="10" duration="1000" coherence="0.4" color="outcome" run pause reset></accumulable-control>
-  <rdk-2afc-task trials="10"></rdk-2afc-task>
+<ddm-example-human trials="10" duration="2000" coherence="0.5" color="outcome">
+  <accumulable-control run pause reset></accumulable-control>
+  <rdk-2afc-task></rdk-2afc-task>
   <accumulable-response interactive trial feedback></accumulable-response>
-  <accumulable-table numeric summary color="outcome"></accumulable-table>
+  <accumulable-table numeric summary></accumulable-table>
   <ddm-parameters></ddm-parameters>
   <ddm-model human measures means sds></ddm-model>
   <ddm-fit></ddm-fit>
@@ -865,6 +893,17 @@ components, as they will be propagated and kept in sync.
 
 - `trials: number = 10`
   - Number of sampled trials to display
+- `color: string = outcome`
+  - How to color the cells in the results table
+  - Options
+    - `'none'`
+      - No use of color
+    - `'measure'`
+      - Color based on measure (*count/accuracy*, *mean RT*, *standard deviation RT*)
+    - `'outcome'`
+      - Color based on outcome (*correct*, *error*, *overall*)
+    - `'all'`
+      - Color based on measure and outcome
 - `boundary-separation: number = 1.5`
   - Boundary separation, in units of evidence, *a*
 - `starting-point: number = 0.5`
@@ -892,11 +931,11 @@ components, as they will be propagated and kept in sync.
 ##### Example
 
 ```html
-<ddm-example-interactive trials="10" boundary-separation="1.2" starting-point="0.35" drift-rate="1.5" nondecision-time="150">
-  <accumulable-control trials="10" resample></accumulable-control>
+<ddm-example-interactive trials="10" color="outcome" boundary-separation="1.2" starting-point="0.35" drift-rate="1.5" nondecision-time="150">
+  <accumulable-control resample></accumulable-control>
   <ddm-parameters interactive></ddm-parameters>
   <ddm-model interactive measures means sds></ddm-model>
-  <accumulable-table numeric summary color="outcome"></accumulable-table>
+  <accumulable-table numeric summary></accumulable-table>
 </ddm-example-interactive>
 ```
 
@@ -963,7 +1002,7 @@ individual components, as they will be propagated and kept in sync.
 
 ```html
 <ddm-example-model trials="10" duration="2000" coherence="0.5" color="outcome" boundary-separation="1.2" starting-point="0.35" drift-rate="1.5" nondecision-time="150">
-  <accumulable-control trials color run pause reset></accumulable-control>
+  <accumulable-control run pause reset></accumulable-control>
   <rdk-2afc-task></rdk-2afc-task>
   <ddm-parameters interactive></ddm-parameters>
   <ddm-model interactive measures means sds></ddm-model>