Added #

• FrameRateDetector for automatic FPS detection (24/25/30/60 FPS snapping).
• FrameRateDetector.recordFrameMicros for monotonic timestamp input and stability gating on low FPS streaks.
• RRIntervalAnalyzer for SDRR and mean BPM analysis.
• FilterResult for outlier filtering statistics.
• PPGSignal fields: frameRate, isFPSStable, sdrr, isSDRRAcceptable, driftRate, rejectionRatio, rejectedIntervalCount.

Changed #

• RR interval calculation now uses detected FPS instead of fixed 30 FPS.
• Outlier filtering includes adjacent interval validation and rejection statistics.
• Signal quality assessment can degrade on excessive baseline drift.
• Threshold values are centralized in PPGConfig.
• Peak detection uses adaptive prominence based on recent filtered signal variability.
• Quality assessment window size now scales with frame rate.
• RR generation is skipped while isFPSStable is false.

Fixed #

• RR intervals were incorrect on non-30 FPS devices (e.g., 60 FPS).

Changed #

• Updated camera dependency to ^0.11.3.

Changed #

• Consolidated example app into single file for better pub.dev visibility.

Added #

• Initial release of flutter_ppg package
• FlutterPPGService - Main orchestrator for PPG signal processing
• SignalProcessor - Red channel extraction and bandpass filtering
• PeakDetector - Heartbeat detection with minimum distance enforcement
• SignalQualityAssessor - Real-time signal quality assessment (Good/Fair/Poor)
• OutlierFilter - IQR-based outlier removal for RR intervals
• RingBuffer - Efficient sliding window utility
• Example app with:
  • Dual waveform visualization (Raw vs Filtered)
  • Peak markers on filtered signal
  • RR interval history display
  • Real-time SNR and quality stats
  • Start/Stop control with 30-second auto-timeout