Improvements #

• Performance: Added debounce (220ms) to search input in UniversalSelector to reduce excessive rebuilds during typing
• Fuzzy search: Added fast length-difference pre-check before computing Levenshtein distance; improved DEBUG logs
• Safety: Made SelectableItem.toString() robust when icon is null
• API unchanged: All changes are internal and backward compatible

Fixes #

• Replaced deprecated withOpacity usages with withValues(alpha: ...)
• Import order and formatting aligned with lint rules

🔒 Security Updates #

• Enhanced .gitignore rules - added comprehensive security rules to prevent API keys and sensitive data leaks
• Browser data protection - excluded chrome-device, firefox-device, safari-device directories
• Cache protection - excluded browser-data, cache, temp, tmp directories
• API key protection - excluded common API key file patterns (api_keys.txt, secrets.json, .env files)

🔧 Bug Fixes #

• Fixed package structure - removed unnecessary zip file from repository
• Updated version - bumped to 1.0.2 for clean publication

🔧 Bug Fixes #

• Fixed API inconsistency in multi-select mode - onItemSelected is now optional for multi-select mode
• Updated documentation - clarified when onItemSelected is required vs optional
• Added API consistency tests - ensures proper callback behavior in both modes

🔄 API Changes

// Before (required onItemSelected even in multi-select)
UniversalSelector(
  items: items,
  selectedItems: selectedItems,
  isMultiSelect: true,
  onItemSelected: (item) {}, // Required but unused
  onItemsSelected: (items) { ... },
)

// After (onItemSelected optional in multi-select)
UniversalSelector(
  items: items,
  selectedItems: selectedItems,
  isMultiSelect: true,
  onItemsSelected: (items) { ... }, // Only this is needed
)

📚 Documentation Updates

• Updated API table to clarify callback requirements
• Added examples showing proper usage in both modes
• Enhanced description of Universal Selection capabilities

🎉 Major Release: Universal Selector #

Completely redesigned package for universal item selection

✨ New Features

• Universal selector - works with any list of items
• Flexible data structure - support for icons, subtitles, additional data
• Fuzzy search - search with typo support and fuzzy matching
• Customizable UI - full customization of colors and styles
• High performance - optimized search algorithm

🔧 Technical Changes

• Removed all translations (19 languages) to reduce package size
• Removed dependency on flutter_localizations
• Renamed main file: country_search.dart → multiselector.dart
• Updated API to work with SelectableItem instead of Country

📦 Package Size

• Before: ~113KB (with translations)
• After: ~50KB (without translations)

🔄 Migration from Previous Versions

// Old code (country_search 2.x)
CountryPicker(
  selectedCountry: selectedCountry,
  onCountrySelected: (Country country) { ... },
)

// New code (multiselector 1.0.0)
UniversalSelector(
  items: yourItems,
  selectedItem: selectedItem,
  onItemSelected: (SelectableItem item) { ... },
)

📚 New API

// Creating items
SelectableItem(
  id: 'unique_id',
  name: 'Display Name',
  icon: '🍎', // optional
  subtitle: 'Description', // optional
  searchData: 'additional search terms', // optional
  data: customData, // optional
)

// Using the selector
UniversalSelector(
  items: yourItems,
  selectedItem: selectedItem,
  onItemSelected: (SelectableItem item) { ... },
  labelText: 'Choose item',
  hintText: 'Search items...',
  showSubtitle: true,
  // UI settings
  backgroundColor: Colors.white,
  accentColor: Colors.blue,
  borderRadius: 12.0,
)

🎯 Use Cases

• Country selection with flags
• Language selection
• Product category selection
• Color selection
• App settings selection
• Any other item lists

🧪 Testing

• Updated all tests for new API
• Added tests for fuzzy search
• Test coverage: 100%

📖 Documentation

• Completely updated README.md
• Added examples for various use cases
• Updated API documentation