riverpod_devtools_tracker 1.0.7

Track Riverpod state changes with detailed call stacks. Debug easily by seeing exactly where state changes originated in your code.

1.0.7

Release Date: 2026-01-16

Bug Fixes

• Fixed dart analyze compatibility issue for pub.dev validation
  • Resolved analyzer plugin compilation error caused by riverpod_generator in example directory
  • Added analyzer exclude rules in analysis_options.yaml to exclude example/**, build/**, and .dart_tool/**
  • Fixes "Failed to compile plugin.dart to an AOT snapshot" error
  • Ensures smooth pub.dev package validation with dart analyze
  • Main library code (lib/**) is still fully analyzed for quality assurance

---

1.0.6

Release Date: 2026-01-16

Compatibility Improvements

• Adjusted SDK version requirements for better pub.dev compatibility
  • Lowered minimum Dart SDK requirement from 3.7.0 to 3.5.0
  • Lowered minimum Flutter SDK requirement from 3.27.0 to 3.24.0
  • Resolves pub.dev analysis environment compatibility issues
  • Fixes "Analysis failed with unexpected output" error during package validation
  • Maintains full compatibility with Riverpod 3.1.0+ and all existing features

---

1.0.5

Release Date: 2026-01-16

Compatibility Improvements

• Adjusted SDK version requirements for better compatibility
  • Lowered minimum Dart SDK requirement from 3.7.0 to 3.5.0
  • Lowered minimum Flutter SDK requirement from 3.27.0 to 3.24.0
  • Improves compatibility with pub.dev analysis environment
  • Still maintains full compatibility with Riverpod 3.1.0+

Code Quality Improvements

• Fixed all Flutter analyze warnings
  • Fixed deprecated dart:html usage with proper ignore annotations
  • Removed unused local variables and methods
  • Improved string interpolation usage instead of concatenation
  • Fixed redundant null initializations
  • Fixed protected member access in tests with proper test helper class
  • Added proper ignore annotations for intentionally unused enum fields
  • Converted function variable assignments to function declarations
  • Fixed timer leak in observer coexistence test

Testing & Quality

• Improved test reliability
  • Fixed "multiple observers can coexist" test timer leak
  • Added proper observer disposal in widget tests
  • Created TestableObserver helper class for testing protected methods
  • All tests now pass cleanly without warnings

DevTools Extension

• Code cleanup
  • Removed unused helper methods (_mergeNearbyRanges, _buildStackTraceSection)
  • Improved code organization in state detail panel
  • Cleaner implementation of file download functionality

---

1.0.4

Release Date: 2026-01-15

New Features

• Event History Local Persistence (PR #31)

  • Events are now persisted to local storage using JSON Lines format
  • History survives DevTools disconnections and app sessions
  • Automatic file size management (max 10 MB)
  • DevTools automatically loads historical events on startup
  • New clearOnStart configuration option to control history behavior
  • New dependency: path_provider for cross-platform file access

• Timeline View (Issue #5)

  • New timeline visualization for state change events
  • Hover interactions for detailed event inspection
  • Improved provider labels for better readability
  • Visual timeline representation of provider lifecycles

• Performance Metrics (Issue #7)

  • Real-time performance metrics collection and visualization
  • Type-safe metrics API with comprehensive testing
  • Monitor state change frequency and patterns

• Provider Dependency Graph (Issue #8)

  • Interactive visualization of provider dependencies
  • Provider type statistics with color indicators
  • Improved provider type detection
  • Visual representation of provider relationships

• Visual Diff Highlighting (Issue #18)

  • Enhanced diff highlighting for state changes
  • Easier identification of what changed between states

DevTools Extension Enhancements

• Rebuilt extension with all new visualization features
• Improved UI/UX for timeline and graph views
• Better hover interactions and tooltips
• Enhanced provider type detection and display

Documentation

• Updated README with Graph View type statistics feature
• Synced Chinese README with performance metrics section
• Enhanced Timeline View documentation

---

1.0.3

Release Date: 2026-01-13

New Features

• Event Export Functionality (Issue #4)

  • Export state change events to JSON and CSV formats
  • Includes provider name, previous/new values, trigger location, and timestamps
  • Removed unnecessary stackTrace field from JSON export for cleaner output
  • Synchronized documentation in both English and Traditional Chinese READMEs

• Stack Trace Parsing Cache with LRU Eviction

  • Implemented caching mechanism to improve parsing performance
  • LRU (Least Recently Used) eviction strategy for efficient memory usage
  • Reduces redundant parsing of identical stack traces

• Periodic Memory Cleanup

  • Automatic periodic cleanup for stack trace cache
  • Enhanced memory cleanup safety with improved error handling
  • Comprehensive code documentation for maintenance

• Selective Provider Tracking

  • Added provider filtering capabilities to track only specific providers
  • Simplified provider filtering API by removing string-based approach
  • Optimized value serialization for better performance
  • Improved filtering ergonomics with type-safe API

DevTools Extension Enhancements

• Dual View Mode
  • New tree view and text view modes for state inspection
  • Diff highlighting for easy identification of changes
  • Tree view set as default for better visual hierarchy
  • Reorganized state detail panel layout for improved UX

Testing & Quality

• Significantly Improved Test Coverage
  • Achieved 87.7% code coverage
  • 334 comprehensive tests across the codebase
  • Ensures reliability and maintainability

Chores

• Code formatting and DevTools extension rebuild
• Merged multiple feature branches into main

1.0.2

Release Date: 2026-01-07

Code Quality Improvements

• Refactored LocaleNotifier to follow Riverpod best practices
  • Removed currentLanguage public getter from LocaleNotifier
  • All public API now exposed through state property only
  • Fixed avoid_public_notifier_properties lint warning
  • Locale to Language conversion moved to usage sites

1.0.1

Release Date: 2026-01-07

Documentation Improvements

• Enhanced README with visual guides

  • Added DevTools extension screenshots for better understanding
  • Renamed image files to English for better accessibility
  • Added visual guides for DevTools setup and configuration
  • Added Provider filtering screenshots and documentation

• Removed development-only content

  • Removed Build Status badge (GitHub Actions workflow removed)
  • Removed "Building the Extension" section (scripts not published in package)
  • Cleaned up documentation to focus on end-user experience

1.0.0

Release Date: 2026-01-07

Package Optimizations

• Optimized package content (compressed size: ~12 MB)

  • Added comprehensive .pubignore to exclude development files
  • Package includes pre-built DevTools extension for Flutter DevTools integration
  • Optimized published content for end users only
  • Note: Size is primarily from DevTools extension's web resources (required for functionality)

• Updated to latest development tools

  • Upgraded flutter_lints to ^6.0.0 (main package and example app)
  • Fixed lint warnings for latest Dart standards
  • Maintained zero static analysis warnings

• Continuous Integration & Deployment

  • GitHub Actions CI/CD workflow for automated testing
  • Automatic format checking, static analysis, and test execution
  • Build status badge for transparency
  • Coverage reporting to Codecov

Features

• RiverpodDevToolsObserver - Automatic provider lifecycle tracking

  • Monitors all provider events (add, update, dispose, error)
  • Captures stack traces to identify state change origins
  • Smart async provider support with stack trace caching

• StackTraceParser - Intelligent call stack analysis

  • Detailed call stack parsing and location detection
  • Filters framework code to show only user code
  • Configurable depth and pattern matching

• TrackerConfig - Flexible configuration system

  • Quick setup with TrackerConfig.forPackage()
  • Advanced customization options
  • Production-ready performance controls
  • Comprehensive inline documentation

• DevTools Extension - Beautiful debugging interface

  • GitHub-style dark theme UI
  • Real-time state change monitoring
  • Interactive provider list with filtering
  • Detailed call chain visualization
  • Multi-language support (English, 繁體中文)

• Console Output - Development-friendly logging

  • Pretty formatted output with emojis and boxes
  • Simple one-line format option
  • Configurable verbosity

• Performance Optimizations

  • Memory leak prevention with automatic stack cache cleanup
  • Configurable cache size limits (default: 100 entries)
  • Automatic expiration of old stack traces (default: 60 seconds)
  • Efficient filtering and serialization

• Quality Assurance

  • Comprehensive test coverage (46 tests: 29 main package + 17 DevTools extension)
  • Zero flutter analyze warnings
  • Zero pub publish warnings
  • Production-ready code quality
  • Automated CI/CD testing on every commit

Compatibility

• Flutter SDK >= 3.27.0
• Dart SDK >= 3.7.0
• flutter_riverpod >= 3.1.0

Documentation

• Complete README with usage examples
• Troubleshooting guide
• Best practices for production use
• Performance optimization tips
• Contributing guidelines (CONTRIBUTING.md)