eye_tracking_plus 0.1.2

eye_tracking_plus: ^0.1.2 copied to clipboard

Added

• Lifecycle & state stream: getStateStream() now emits initializing → ready → warmingUp → tracking / paused / calibrating / error. warmingUp flips to tracking only after the first valid gaze sample.
• Attention-aware confidence (Web): per-frame confidence blends page visibility & focus, viewport in-bounds, and frame freshness; smoothed with two-rate EMA and capped (~0.90).
• Real calibration accuracy: train+eval around each calibration point; returns a true 0–1 score normalized by viewport diagonal, cached for fast reads.
• Extensibility: setTracker, setRegression, addTrackerModule, addRegressionModule.
• Robust timestamps: DOM High-Res → epoch via page-start offset; ~30 FPS throttling.

Changed #

• setAccuracyMode('fast') now maps to threadedRidge (instead of linear).
• Auto-calibration simplified (center point) to reduce boot time.
• Replaced fixed 0.8/0.3 confidence stub with the attention-aware model.

Fixed #

• “Ready before ready” glitch: tracking no longer reports ready until real samples arrive.
• Reduced UI jank on start by gating state & throttling emits.

Migration notes #

• Handle the warmingUp state before assuming live tracking.
• Confidence scale is more conservative (max ~0.90). Review any thresholds (e.g. treat >0.6 as “usable”).
• getCalibrationAccuracy() now returns measured values; remove any hardcoded defaults.

Added

• Warm gate (pre-warm) API: to GazeService so the app can ensure at least one successful “warm” before any tracking, calibrating, or scoring.

• warmedonce flag: that becomes true after the first successful warm streak and stays true for the session unless the platform resets.

• warmedonce stream: emits warm-readiness changes (false→true, and back to false if a hard reset happens).

Changed

• Start flow is now gated:

startTracking() will refuse to start if warmedonce flag is false. It first tries prewarm once; if still not ready, it returns without starting tracking and leaves UI in Ready with a clear status.

• Race-safe warm implementation
• Timeout fallback: cancels warm and returns to ready (warming timeout -> ready) without crashing.

Developer Notes / Migration

Interface changes (new API is implemented only on web)