/// Performance optimization utilities - Export file
///
/// This file provides easy access to all performance optimization utilities.
/// Import this single file to get access to all performance features.
///
/// Usage:
/// ```dart
/// import 'package:retail/core/performance.dart';
/// ```

// Image Caching
export 'config/image_cache_config.dart';

// Performance Constants
export 'constants/performance_constants.dart';

// Utilities
export 'utils/debouncer.dart';
export 'utils/database_optimizer.dart';
export 'utils/performance_monitor.dart';
// Note: provider_optimization.dart archived - use Riverpod's built-in .select() instead
export 'utils/responsive_helper.dart';

// Optimized Widgets
export 'widgets/optimized_cached_image.dart';
export 'widgets/optimized_grid_view.dart';
export 'widgets/optimized_list_view.dart';

/// Quick Start Guide:
///
/// 1. Image Optimization:
///    ```dart
///    ProductGridImage(imageUrl: url, size: 150)
///    ```
///
/// 2. Grid Optimization:
///    ```dart
///    ProductGridView(products: products, itemBuilder: ...)
///    ```
///
/// 3. State Optimization:
///    ```dart
///    final name = ref.watchField(provider, (state) => state.name)
///    ```
///
/// 4. Database Optimization:
///    ```dart
///    await DatabaseOptimizer.batchWrite(box, items)
///    ```
///
/// 5. Search Debouncing:
///    ```dart
///    final searchDebouncer = SearchDebouncer();
///    searchDebouncer.run(() => search(query));
///    ```
///
/// 6. Performance Monitoring:
///    ```dart
///    await PerformanceMonitor().trackAsync('operation', () async {...});
///    PerformanceMonitor().printSummary();
///    ```
///
/// 7. Responsive Helpers:
///    ```dart
///    if (context.isMobile) { ... }
///    final columns = context.gridColumns;
///    ```
///
/// See PERFORMANCE_GUIDE.md for complete documentation.