flutter_shared_utilities 1.0.1

A comprehensive Flutter utilities package with extensions, models, and utility functions.

Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

1.0.1

Added

• Comprehensive documentation and examples in README
• Production-ready package structure
• Badges for pub.dev, license, and Flutter version
• Detailed API reference with code examples
• Contributing guidelines
• Issue and feedback links

Changed

• Updated package description for better clarity
• Enhanced documentation with emojis and better formatting
• Improved code examples with practical use cases

Fixed

• Package naming consistency (flutter_shared_utilities)
• Documentation structure and completeness

1.0.0

Added

• String Extensions: Case-insensitive string operations, JSON validation, and utility methods

  • compareWithoutCase() - Case-insensitive string comparison
  • startsWithIgnoreCase() - Case-insensitive prefix checking
  • containsWithoutCase() - Case-insensitive substring search
  • isNullString, isNullEmpty - Null and empty string checks
  • isJsonObject, isJsonArray, isJsonPrimitive - JSON format validation

• List Extensions: Smart list operations with duplicate prevention

  • insertIfNotExists() - Insert item only if it doesn't exist
  • addAllIfNotExists() - Add multiple items, skipping duplicates
  • removeIfExist() - Remove item if it exists in the list
  • Custom equality checker support for complex objects

• Safe Parser: Robust JSON parsing with error handling

  • safeEncodeJson() - Safe JSON encoding with error handling
  • safeDecodeJson() - Safe JSON decoding with validation
  • parseIterable() - Type-safe iterable parsing

• Base Data Model: Abstract class for consistent data handling

  • fromMap() - Convert Map to model instance
  • toMap() - Convert model to Map
  • fromJson() - Convert JSON string to model instance
  • toJson() - Convert model to JSON string
  • Equatable integration for value equality

• Object Serialization Extensions: Safe type conversion utilities

  • fromSerializable<T>() - Safe type conversion with null safety

• Interfaces: Abstract interfaces for common services

  • AppLogger - Application logging interface
  • ConnectivityService - Network connectivity management interface

• Utility Functions: Additional helper utilities

  • safeDebugLog() - Safe debug logging with stack trace support

• Color Extensions: Enhanced color manipulation utilities

• Map Extensions: Safe map parsing and utility functions

• Iterable Extensions: Utility functions for iterable collections

Technical Features

• Full null safety support
• Comprehensive type checking
• Error handling and safe parsing
• Custom lint rules for code quality
• Flutter 3.0+ compatibility
• Dart SDK 3.8.1+ support

Dependencies

• equatable: ^2.0.7 - For value equality
• collection: ^1.19.1 - For collection utilities
• custom_lint: ^0.7.5 - For custom linting rules
• flutter_custom_lints: ^1.0.2 - For Flutter-specific linting