@jspsych/plugin-tobii-user-position 0.1.1

package/src/index.js

@@ -0,0 +1,337 @@
+/**
+ * @title Tobii User Position
+ * @description jsPsych plugin for Tobii eye tracker user position guide. Displays real-time
+ * head position feedback to help participants maintain optimal positioning for eye tracking.
+ * @version 1.0.0
+ * @author jsPsych Team
+ * @see {@link https://github.com/jspsych/jspsych-tobii/tree/main/packages/plugin-tobii-user-position#readme Documentation}
+ */
+import { ParameterType } from 'jspsych';
+import { version } from '../package.json';
+import { PositionDisplay } from './position-display';
+const info = {
+    name: 'tobii-user-position',
+    version: version,
+    parameters: {
+        /** Duration to show the position guide (ms), null for manual */
+        duration: {
+            type: ParameterType.INT,
+            default: null,
+        },
+        /** Message to display */
+        message: {
+            type: ParameterType.STRING,
+            default: 'Please position yourself so the indicators are green',
+        },
+        /** Update interval (ms) */
+        update_interval: {
+            type: ParameterType.INT,
+            default: 100,
+        },
+        /** Show distance feedback */
+        show_distance_feedback: {
+            type: ParameterType.BOOL,
+            default: true,
+        },
+        /** Show position feedback */
+        show_position_feedback: {
+            type: ParameterType.BOOL,
+            default: true,
+        },
+        /** Button text for manual continuation */
+        button_text: {
+            type: ParameterType.STRING,
+            default: 'Continue',
+        },
+        /** Only show button when position is good */
+        require_good_position: {
+            type: ParameterType.BOOL,
+            default: false,
+        },
+        /** Background color */
+        background_color: {
+            type: ParameterType.STRING,
+            default: '#f0f0f0',
+        },
+        /** Good position color */
+        good_color: {
+            type: ParameterType.STRING,
+            default: '#28a745',
+        },
+        /** Fair position color */
+        fair_color: {
+            type: ParameterType.STRING,
+            default: '#ffc107',
+        },
+        /** Poor position color */
+        poor_color: {
+            type: ParameterType.STRING,
+            default: '#dc3545',
+        },
+        /** Button color */
+        button_color: {
+            type: ParameterType.STRING,
+            default: '#007bff',
+        },
+        /** Button hover color */
+        button_hover_color: {
+            type: ParameterType.STRING,
+            default: '#0056b3',
+        },
+        /** Font size */
+        font_size: {
+            type: ParameterType.STRING,
+            default: '18px',
+        },
+        /** Position offset threshold for "good" status (normalized, default 0.15) */
+        position_threshold_good: {
+            type: ParameterType.FLOAT,
+            default: 0.15,
+        },
+        /** Position offset threshold for "fair" status (normalized, default 0.25) */
+        position_threshold_fair: {
+            type: ParameterType.FLOAT,
+            default: 0.25,
+        },
+        /** Distance offset threshold for "good" status (normalized, default 0.1) */
+        distance_threshold_good: {
+            type: ParameterType.FLOAT,
+            default: 0.1,
+        },
+        /** Distance offset threshold for "fair" status (normalized, default 0.2) */
+        distance_threshold_fair: {
+            type: ParameterType.FLOAT,
+            default: 0.2,
+        },
+    },
+    data: {
+        /** Average X position during trial */
+        average_x: {
+            type: ParameterType.FLOAT,
+        },
+        /** Average Y position during trial */
+        average_y: {
+            type: ParameterType.FLOAT,
+        },
+        /** Average Z position (distance) during trial */
+        average_z: {
+            type: ParameterType.FLOAT,
+        },
+        /** Whether position was good at end */
+        position_good: {
+            type: ParameterType.BOOL,
+        },
+        /** Horizontal position status */
+        horizontal_status: {
+            type: ParameterType.STRING,
+        },
+        /** Vertical position status */
+        vertical_status: {
+            type: ParameterType.STRING,
+        },
+        /** Distance status */
+        distance_status: {
+            type: ParameterType.STRING,
+        },
+        /** Duration of trial */
+        rt: {
+            type: ParameterType.INT,
+        },
+    },
+};
+class TobiiUserPositionPlugin {
+    constructor(jsPsych) {
+        this.jsPsych = jsPsych;
+    }
+    static removeStyles() {
+        const el = document.getElementById('tobii-user-position-styles');
+        if (el) {
+            el.remove();
+        }
+    }
+    injectStyles(trial) {
+        // Remove existing styles so each trial gets its own colors
+        TobiiUserPositionPlugin.removeStyles();
+        const css = `
+      .tobii-user-position-container {
+        display: flex;
+        flex-direction: column;
+        align-items: center;
+        justify-content: center;
+        width: 100%;
+        height: 100vh;
+        font-family: 'Open Sans', -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, Oxygen, Ubuntu, sans-serif;
+        font-size: ${trial.font_size};
+      }
+
+      .tobii-user-position-message {
+        margin-bottom: 40px;
+        text-align: center;
+        font-weight: 500;
+        color: #333;
+      }
+
+      .tobii-user-position-guide {
+        position: relative;
+        margin-bottom: 40px;
+      }
+
+      .tobii-position-feedback {
+        text-align: center;
+        margin-bottom: 30px;
+        font-weight: 600;
+        font-size: 1.1em;
+      }
+
+      .tobii-user-position-button {
+        padding: 12px 32px;
+        font-size: 16px;
+        font-weight: 500;
+        border: none;
+        border-radius: 6px;
+        background-color: ${trial.button_color};
+        color: white;
+        cursor: pointer;
+        transition: all 0.2s ease;
+        box-shadow: 0 2px 4px rgba(0, 0, 0, 0.2);
+      }
+
+      .tobii-user-position-button:hover:not(:disabled) {
+        background-color: ${trial.button_hover_color};
+        box-shadow: 0 4px 8px rgba(0, 0, 0, 0.3);
+        transform: translateY(-1px);
+      }
+
+      .tobii-user-position-button:disabled {
+        background-color: #ccc;
+        cursor: not-allowed;
+        opacity: 0.6;
+      }
+
+      .tobii-center-marker {
+        position: absolute;
+        top: 50%;
+        left: 50%;
+        transform: translate(-50%, -50%);
+        width: 30px;
+        height: 30px;
+        border: 2px dashed #666;
+        border-radius: 50%;
+        opacity: 0.5;
+      }
+    `;
+        const styleElement = document.createElement('style');
+        styleElement.id = 'tobii-user-position-styles';
+        styleElement.textContent = css;
+        document.head.appendChild(styleElement);
+    }
+    trial(display_element, trial) {
+        return new Promise((resolve) => {
+            // Inject CSS
+            this.injectStyles(trial);
+            // Check for Tobii extension
+            const tobiiExtension = this.jsPsych.extensions.tobii;
+            if (!tobiiExtension) {
+                throw new Error('Tobii extension not loaded');
+            }
+            // Create container
+            display_element.innerHTML = `
+        <div class="tobii-user-position-container">
+        </div>
+      `;
+            const container = display_element.querySelector('.tobii-user-position-container');
+            // Create position display
+            const positionDisplay = new PositionDisplay(container, {
+                message: trial.message,
+                showDistanceFeedback: trial.show_distance_feedback,
+                showPositionFeedback: trial.show_position_feedback,
+                backgroundColor: trial.background_color,
+                goodColor: trial.good_color,
+                fairColor: trial.fair_color,
+                poorColor: trial.poor_color,
+                fontSize: trial.font_size,
+                positionThresholdGood: trial.position_threshold_good,
+                positionThresholdFair: trial.position_threshold_fair,
+                distanceThresholdGood: trial.distance_threshold_good,
+                distanceThresholdFair: trial.distance_threshold_fair,
+            });
+            // Add continue button if no duration specified
+            let continueButton = null;
+            if (trial.duration === null) {
+                continueButton = document.createElement('button');
+                continueButton.className = 'tobii-user-position-button';
+                continueButton.textContent = trial.button_text;
+                if (trial.require_good_position) {
+                    continueButton.disabled = true;
+                }
+                container.appendChild(continueButton);
+            }
+            // Track position data
+            const positionSamples = [];
+            const startTime = performance.now();
+            // Update position display periodically
+            const updateInterval = setInterval(async () => {
+                try {
+                    const positionData = await tobiiExtension.getUserPosition();
+                    positionDisplay.updatePosition(positionData);
+                    // Track position quality
+                    const quality = positionDisplay.getCurrentQuality(positionData);
+                    positionSamples.push(quality);
+                    // Update button state if required
+                    if (continueButton && trial.require_good_position) {
+                        continueButton.disabled = !quality.isGoodPosition;
+                    }
+                }
+                catch (error) {
+                    console.error('Error updating user position:', error);
+                }
+            }, trial.update_interval);
+            // Cleanup helper to ensure DOM and styles are always cleaned up
+            const cleanup = () => {
+                clearInterval(updateInterval);
+                positionDisplay.destroy();
+                display_element.innerHTML = '';
+                TobiiUserPositionPlugin.removeStyles();
+            };
+            // Handle trial end
+            const endTrial = () => {
+                // Calculate average position
+                const validSamples = positionSamples.filter((s) => s.averageX !== null && s.averageY !== null && s.averageZ !== null);
+                let averageX = null;
+                let averageY = null;
+                let averageZ = null;
+                let finalQuality = null;
+                if (validSamples.length > 0) {
+                    averageX = validSamples.reduce((sum, s) => sum + s.averageX, 0) / validSamples.length;
+                    averageY = validSamples.reduce((sum, s) => sum + s.averageY, 0) / validSamples.length;
+                    averageZ = validSamples.reduce((sum, s) => sum + s.averageZ, 0) / validSamples.length;
+                    finalQuality = positionSamples[positionSamples.length - 1];
+                }
+                const trialData = {
+                    average_x: averageX,
+                    average_y: averageY,
+                    average_z: averageZ,
+                    position_good: finalQuality?.isGoodPosition ?? false,
+                    horizontal_status: finalQuality?.horizontalStatus ?? 'poor',
+                    vertical_status: finalQuality?.verticalStatus ?? 'poor',
+                    distance_status: finalQuality?.distanceStatus ?? 'poor',
+                    rt: Math.round(performance.now() - startTime),
+                };
+                cleanup();
+                this.jsPsych.finishTrial(trialData);
+                resolve();
+            };
+            // Set up continue button
+            if (continueButton) {
+                continueButton.addEventListener('click', endTrial);
+            }
+            // Set up duration timeout
+            if (trial.duration != null) {
+                this.jsPsych.pluginAPI.setTimeout(endTrial, trial.duration);
+            }
+        });
+    }
+}
+TobiiUserPositionPlugin.info = info;
+export default TobiiUserPositionPlugin;
+//# sourceMappingURL=index.js.map

package/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["index.ts"],"names":[],"mappings":"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"}

package/src/index.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.spec.d.ts.map

package/src/index.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.spec.d.ts","sourceRoot":"","sources":["index.spec.ts"],"names":[],"mappings":""}

package/src/index.spec.js

@@ -0,0 +1,102 @@
+import { initJsPsych } from 'jspsych';
+import TobiiUserPositionPlugin from '.';
+describe('TobiiUserPositionPlugin', () => {
+    describe('static info', () => {
+        it('should have correct name', () => {
+            expect(TobiiUserPositionPlugin.info.name).toBe('tobii-user-position');
+        });
+        it('should have version defined', () => {
+            expect(TobiiUserPositionPlugin.info.version).toBeDefined();
+        });
+    });
+    describe('parameters', () => {
+        const params = TobiiUserPositionPlugin.info.parameters;
+        it('should have duration parameter with default null', () => {
+            expect(params.duration).toBeDefined();
+            expect(params.duration.default).toBeNull();
+        });
+        it('should have message parameter', () => {
+            expect(params.message).toBeDefined();
+            expect(typeof params.message.default).toBe('string');
+        });
+        it('should have update_interval parameter with default 100', () => {
+            expect(params.update_interval).toBeDefined();
+            expect(params.update_interval.default).toBe(100);
+        });
+        it('should have show_distance_feedback parameter', () => {
+            expect(params.show_distance_feedback).toBeDefined();
+            expect(params.show_distance_feedback.default).toBe(true);
+        });
+        it('should have show_position_feedback parameter', () => {
+            expect(params.show_position_feedback).toBeDefined();
+            expect(params.show_position_feedback.default).toBe(true);
+        });
+        it('should have button_text parameter', () => {
+            expect(params.button_text).toBeDefined();
+            expect(params.button_text.default).toBe('Continue');
+        });
+        it('should have require_good_position parameter', () => {
+            expect(params.require_good_position).toBeDefined();
+            expect(params.require_good_position.default).toBe(false);
+        });
+        it('should have color parameters', () => {
+            expect(params.background_color).toBeDefined();
+            expect(params.good_color).toBeDefined();
+            expect(params.fair_color).toBeDefined();
+            expect(params.poor_color).toBeDefined();
+            expect(params.button_color).toBeDefined();
+            expect(params.button_hover_color).toBeDefined();
+        });
+        it('should have position_threshold_good parameter with default 0.15', () => {
+            expect(params.position_threshold_good).toBeDefined();
+            expect(params.position_threshold_good.default).toBe(0.15);
+        });
+        it('should have position_threshold_fair parameter with default 0.25', () => {
+            expect(params.position_threshold_fair).toBeDefined();
+            expect(params.position_threshold_fair.default).toBe(0.25);
+        });
+        it('should have distance_threshold_good parameter with default 0.1', () => {
+            expect(params.distance_threshold_good).toBeDefined();
+            expect(params.distance_threshold_good.default).toBe(0.1);
+        });
+        it('should have distance_threshold_fair parameter with default 0.2', () => {
+            expect(params.distance_threshold_fair).toBeDefined();
+            expect(params.distance_threshold_fair.default).toBe(0.2);
+        });
+        it('should have font_size parameter with default 18px', () => {
+            expect(params.font_size).toBeDefined();
+            expect(params.font_size.default).toBe('18px');
+        });
+    });
+    describe('data specification', () => {
+        const data = TobiiUserPositionPlugin.info.data;
+        it('should have average_x data field', () => {
+            expect(data.average_x).toBeDefined();
+        });
+        it('should have average_y data field', () => {
+            expect(data.average_y).toBeDefined();
+        });
+        it('should have average_z data field', () => {
+            expect(data.average_z).toBeDefined();
+        });
+        it('should have position_good data field', () => {
+            expect(data.position_good).toBeDefined();
+        });
+        it('should have status data fields', () => {
+            expect(data.horizontal_status).toBeDefined();
+            expect(data.vertical_status).toBeDefined();
+            expect(data.distance_status).toBeDefined();
+        });
+        it('should have rt data field', () => {
+            expect(data.rt).toBeDefined();
+        });
+    });
+    describe('instantiation', () => {
+        it('should instantiate without errors', () => {
+            const jsPsych = initJsPsych();
+            const plugin = new TobiiUserPositionPlugin(jsPsych);
+            expect(plugin).toBeDefined();
+        });
+    });
+});
+//# sourceMappingURL=index.spec.js.map

package/src/index.spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.spec.js","sourceRoot":"","sources":["index.spec.ts"],"names":[],"mappings":"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"}

package/src/index.spec.ts

@@ -0,0 +1,126 @@
+import { initJsPsych } from 'jspsych';
+
+import TobiiUserPositionPlugin from '.';
+
+describe('TobiiUserPositionPlugin', () => {
+  describe('static info', () => {
+    it('should have correct name', () => {
+      expect(TobiiUserPositionPlugin.info.name).toBe('tobii-user-position');
+    });
+
+    it('should have version defined', () => {
+      expect(TobiiUserPositionPlugin.info.version).toBeDefined();
+    });
+  });
+
+  describe('parameters', () => {
+    const params = TobiiUserPositionPlugin.info.parameters;
+
+    it('should have duration parameter with default null', () => {
+      expect(params.duration).toBeDefined();
+      expect(params.duration.default).toBeNull();
+    });
+
+    it('should have message parameter', () => {
+      expect(params.message).toBeDefined();
+      expect(typeof params.message.default).toBe('string');
+    });
+
+    it('should have update_interval parameter with default 100', () => {
+      expect(params.update_interval).toBeDefined();
+      expect(params.update_interval.default).toBe(100);
+    });
+
+    it('should have show_distance_feedback parameter', () => {
+      expect(params.show_distance_feedback).toBeDefined();
+      expect(params.show_distance_feedback.default).toBe(true);
+    });
+
+    it('should have show_position_feedback parameter', () => {
+      expect(params.show_position_feedback).toBeDefined();
+      expect(params.show_position_feedback.default).toBe(true);
+    });
+
+    it('should have button_text parameter', () => {
+      expect(params.button_text).toBeDefined();
+      expect(params.button_text.default).toBe('Continue');
+    });
+
+    it('should have require_good_position parameter', () => {
+      expect(params.require_good_position).toBeDefined();
+      expect(params.require_good_position.default).toBe(false);
+    });
+
+    it('should have color parameters', () => {
+      expect(params.background_color).toBeDefined();
+      expect(params.good_color).toBeDefined();
+      expect(params.fair_color).toBeDefined();
+      expect(params.poor_color).toBeDefined();
+      expect(params.button_color).toBeDefined();
+      expect(params.button_hover_color).toBeDefined();
+    });
+
+    it('should have position_threshold_good parameter with default 0.15', () => {
+      expect(params.position_threshold_good).toBeDefined();
+      expect(params.position_threshold_good.default).toBe(0.15);
+    });
+
+    it('should have position_threshold_fair parameter with default 0.25', () => {
+      expect(params.position_threshold_fair).toBeDefined();
+      expect(params.position_threshold_fair.default).toBe(0.25);
+    });
+
+    it('should have distance_threshold_good parameter with default 0.1', () => {
+      expect(params.distance_threshold_good).toBeDefined();
+      expect(params.distance_threshold_good.default).toBe(0.1);
+    });
+
+    it('should have distance_threshold_fair parameter with default 0.2', () => {
+      expect(params.distance_threshold_fair).toBeDefined();
+      expect(params.distance_threshold_fair.default).toBe(0.2);
+    });
+
+    it('should have font_size parameter with default 18px', () => {
+      expect(params.font_size).toBeDefined();
+      expect(params.font_size.default).toBe('18px');
+    });
+  });
+
+  describe('data specification', () => {
+    const data = TobiiUserPositionPlugin.info.data;
+
+    it('should have average_x data field', () => {
+      expect(data.average_x).toBeDefined();
+    });
+
+    it('should have average_y data field', () => {
+      expect(data.average_y).toBeDefined();
+    });
+
+    it('should have average_z data field', () => {
+      expect(data.average_z).toBeDefined();
+    });
+
+    it('should have position_good data field', () => {
+      expect(data.position_good).toBeDefined();
+    });
+
+    it('should have status data fields', () => {
+      expect(data.horizontal_status).toBeDefined();
+      expect(data.vertical_status).toBeDefined();
+      expect(data.distance_status).toBeDefined();
+    });
+
+    it('should have rt data field', () => {
+      expect(data.rt).toBeDefined();
+    });
+  });
+
+  describe('instantiation', () => {
+    it('should instantiate without errors', () => {
+      const jsPsych = initJsPsych();
+      const plugin = new TobiiUserPositionPlugin(jsPsych);
+      expect(plugin).toBeDefined();
+    });
+  });
+});