🚀 Initial Release - Comprehensive Flutter Utility Library #

This is the initial release of Ajit Basic Utils, a comprehensive Flutter utility library with 100+ essential tools across multiple categories.

Added #

• Text Generators: Bubble text, upside-down text, glitch effects, Lorem Ipsum
• Calculators: GPA, BMI, age, scientific functions (factorial, power, roots, logarithms)
• Converters: Speed, temperature, length, memory, area, volume conversions
• Password Tools: Password generation, strength checking, bulk generation
• Encoders/Decoders: Base64, binary, URL, hex, ROT13 encoding/decoding
• Hash Tools: MD5, SHA1, SHA224, SHA256, SHA384, SHA512, HMAC
• Validators: Email, phone, URL, credit card, timestamp validation
• Text Processors: Text cleaning, replacement, case conversion, word density
• Network Tools: IP subnet calculator, MX lookup, URL parser, SSL checker
• Image Tools: OCR, compression, rotation, format conversion, resizing
• QR Tools: QR code generation and parsing
• Date Utils: Date formatting, calculations, weekend detection
• String Utils: Random generation, manipulation, formatting
• Number Utils: Random generation, formatting, mathematical operations
• File Utils: Extension detection, size formatting, type checking
• Network Utils: IP validation, domain extraction, URL validation

Technical Details #

• Package Name: ajit_basic_utils
• Version: 1.0.0+1
• Dependencies: http, crypto, convert, intl, uuid, image, qr_flutter, xml, flutter_colorpicker
• Platform Support: Flutter, Dart, Web, Android, iOS, macOS, Windows, Linux
• Documentation: Comprehensive README with examples and API documentation
• Example App: Complete Flutter app demonstrating all features

Fixed #

• Fixed recursive method calls in HashTools that caused stack overflow
• Resolved Android build issues by removing problematic qr_code_scanner dependency
• Fixed nested class declarations across all utility files
• Updated package name to flutter_basic_utils to avoid conflicts

Changed #

• Package name changed from basic_utils to flutter_basic_utils
• Version updated to 1.0.2+1 for pub.flutter-io.cn compatibility

🚀 Major Release - 100+ New Features Added! #

This is a major release that transforms the Basic Utils library into a comprehensive toolkit with 100+ essential utilities across 13 new categories.

Added #

🎨 Text Generators

• TextGenerators: Fun text effect generators
  • generateBubbleText() - Convert text to circled Unicode characters
  • generateUpsideDownText() - Flip text upside down
  • generateGlitchText() - Add random character substitutions with intensity control
  • generateLoremIpsum() - Generate placeholder text with customizable paragraphs and words
  • generateRandomText() - Generate random text with configurable options
  • generateStrikethroughText() - Add strikethrough effect
  • generateUnderlineText() - Add underline effect
  • generateTextRepeater() - Repeat text with custom separators
  • generateAsciiArt() - Convert text to ASCII art

🧮 Advanced Calculators

• Calculators: Comprehensive calculation tools
  • calculateGPA() - Grade Point Average calculation with credit hours
  • calculateSimpleInterest() - Simple interest calculation
  • calculateCompoundInterest() - Compound interest with customizable frequency
  • calculateCompoundProfit() - Investment growth calculations with contributions
  • calculateAge() - Age calculation in years, months, and days
  • calculateBMI() - Body Mass Index with health categories
  • calculateEMI() - Loan EMI calculations
  • calculateAmortizationSchedule() - Detailed loan payment schedule
  • calculateInvestmentReturns() - Investment return calculations
  • ScientificCalculator: Advanced mathematical functions
    • factorial(), power(), sqrt(), cbrt(), nthRoot()
    • log10(), ln(), logBase() - Logarithmic functions
    • sin(), cos(), tan(), asin(), acos(), atan() - Trigonometric functions
    • degreesToRadians(), radiansToDegrees() - Angle conversions
    • abs(), ceil(), floor(), round(), modulo() - Basic math operations
    • percentage(), percentageChange() - Percentage calculations

🔄 Unit Converters

• Converters: Comprehensive unit conversion system
  • LengthConverter: mm, cm, m, km, in, ft, yd, mi
  • SpeedConverter: m/s, km/h, mph, ft/s, knot
  • TemperatureConverter: Celsius, Fahrenheit, Kelvin
  • WeightConverter: mg, g, kg, oz, lb, ton
  • MemoryConverter: B, KB, MB, GB, TB, PB with human-readable formatting
  • AreaConverter: mm², cm², m², km², in², ft², acre, hectare
  • VolumeConverter: ml, l, gal, qt, pt, cup, fl oz, tbsp, tsp
  • TimeConverter: ms, s, min, h, d, w, mo, y with duration formatting
  • PressureConverter: Pa, kPa, MPa, bar, atm, psi, torr
  • EnergyConverter: J, kJ, MJ, cal, kcal, Wh, kWh, BTU
  • PowerConverter: W, kW, MW, hp, BTU/h
  • CurrencyConverter: Currency conversion with exchange rates

🖼️ Image Tools

• ImageTools: Comprehensive image processing utilities
  • ImageOcr: Text extraction from images (placeholder implementation)
  • ImageCompressor: Image compression with quality control and format conversion
  • ImageRotator: Image rotation (90°, 180°, 270°) and flipping
  • ImageConverter: Format conversion (JPG, PNG, WebP) and grayscale conversion
  • ImageResizer: Image resizing with aspect ratio control and cropping
  • ImageToBase64: Base64 encoding/decoding for images
  • ImageEffects: Image effects (blur, brightness, contrast, sepia)

🔐 Encoders/Decoders

• EncodersDecoders: Comprehensive encoding/decoding utilities
  • Base64Converter: Base64 encoding/decoding with validation
  • BinaryConverter: Text to/from binary conversion
  • Rot13Converter: ROT13 cipher implementation
  • QuotedPrintableConverter: Email quoted-printable encoding/decoding
  • PunycodeConverter: Internationalized domain name encoding/decoding
  • UrlConverter: URL encoding/decoding with parsing utilities
  • HtmlConverter: HTML entity encoding/decoding
  • HexConverter: Hexadecimal encoding/decoding with validation
  • CaesarCipher: Custom shift cipher implementation
  • MorseCodeConverter: Morse code encoding/decoding

📄 JSON/XML Tools

• JsonXmlTools: Data format processing utilities
  • JsonTools: JSON processing
    • beautify(), minify() - JSON formatting
    • isValid(), getValidationError() - JSON validation
    • jsonToXml(), xmlToJson() - Format conversion
    • extractValue(), mergeJson() - JSON manipulation
    • compare(), getSchema() - JSON analysis
  • XmlTools: XML processing
    • beautify(), minify() - XML formatting
    • isValid(), getValidationError() - XML validation
    • extractValues(), getSchema() - XML analysis
    • xmlToCsv() - XML to CSV conversion
  • CsvTools: CSV processing
    • csvToJson(), jsonToCsv() - CSV/JSON conversion
    • isValid() - CSV validation

🌐 Network Tools

• NetworkTools: Advanced network utilities
  • MxLookup: Mail exchange record lookup
  • IpSubnetCalculator: IP subnet calculations and CIDR notation
  • UrlParser: Comprehensive URL parsing and analysis
  • SslChecker: SSL certificate validation and information
  • PingTools: Host ping utilities with detailed statistics
  • HttpStatusChecker: HTTP status code checking and analysis
  • WebsiteStatusChecker: Comprehensive website status analysis
  • UrlUnshortener: URL unshortening with redirect chain tracking
  • IpInfo: IP geolocation and information services
  • UserAgentTools: User agent generation and parsing

🔑 Password Tools

• PasswordTools: Password generation and security utilities
  • generatePassword() - Secure password generation with customizable options
  • generateBulkPasswords() - Bulk password generation
  • checkPasswordStrength() - Comprehensive password strength analysis
  • generateBcryptHash() - bcrypt hash generation
  • verifyBcryptHash() - bcrypt hash verification
  • generatePassphrase() - Memorable passphrase generation
  • generatePin() - Numeric PIN generation
  • generateMemorablePassword() - Pattern-based password generation
  • isCommonPassword() - Common password detection
  • generateCustomPassword() - Custom character set password generation

📝 Text Processors

• TextProcessors: Advanced text processing utilities
  • TextCleaner: Text cleaning and normalization
    • cleanWhitespace(), removeWhitespace(), removeLineBreaks()
    • removeDuplicateLines(), removeSpecialCharacters()
    • removeHtmlTags(), removeUrls(), removeEmails()
    • removePhoneNumbers(), removeNumbers(), removePunctuation()
    • cleanText() - Comprehensive text cleaning with options
  • TextReplacer: Text replacement utilities
    • replaceIgnoreCase(), replaceMultiple(), replaceRegex()
    • replaceWithCallback() - Callback-based replacement
  • CaseConverter: Case conversion utilities
    • toCamelCase(), toPascalCase(), toSnakeCase(), toKebabCase()
    • toConstantCase(), toTitleCase(), toSentenceCase(), toggleCase()
  • WordDensityCounter: Text analysis utilities
    • countWordFrequency(), getMostFrequentWords(), countCharacterFrequency()
    • getWordDensity(), analyzeText() - Comprehensive text analysis
  • TextSeparator: Text separation utilities
    • separateByLines(), separateBySentences(), separateByWords()
    • separateByParagraphs(), separateByDelimiter()
  • SlugConverter: URL-friendly text conversion
    • toSlug(), toFilenameSlug()

⏰ Timers & Widgets

• TimersWidgets: Timing and UI utilities
  • CountdownTimer: Countdown timer with stream support
  • StopwatchTools: Stopwatch utilities with formatting
  • ColorPicker: Color generation and manipulation
    • generateRandomColor(), rgbToHex(), hexToRgb()
    • rgbToHsl(), hslToRgb(), generateColorPalette()
    • getComplementaryColor(), isDarkColor(), getBrightness()
  • DatePicker: Date and calendar utilities
    • getCurrentDate(), getDateRange(), getWeekDates(), getMonthDates()
    • formatDate(), parseDate(), isWeekend(), isHoliday()
    • getBusinessDays() - Business day calculations
  • WheelTools: Random generation utilities
    • generateRandomNumber(), generateRandomDouble(), generateRandomBoolean()
    • generateRandomString(), shuffleList(), pickRandomItem(), pickRandomItems()

✅ Advanced Validators

• AdvancedValidators: Enhanced validation utilities
  • PalindromeChecker: Palindrome detection with various options
  • HttpStatusCodeChecker: HTTP status code analysis and information
  • WebsiteStatusValidator: Website status validation
  • CreditCardValidator: Credit card validation with type detection
  • TimestampValidator: Timestamp validation and conversion
  • IdnValidator: Internationalized domain name validation

📱 QR Tools

• QrTools: QR code generation and processing
  • QrGenerator: QR code generation for various data types
    • generateQrData() - Basic QR code generation
    • generateQrForUrl() - URL QR codes
    • generateQrForEmail() - Email QR codes with subject/body
    • generateQrForPhone() - Phone number QR codes
    • generateQrForSms() - SMS QR codes
    • generateQrForWifi() - WiFi QR codes with security
    • generateQrForContact() - Contact (vCard) QR codes
    • generateQrForLocation() - Location QR codes
    • generateQrForCalendar() - Calendar event QR codes
  • QrReader: QR code parsing and analysis
    • parseQrData() - Parse QR code data
    • validateQrData() - Validate QR code data
    • extractText(), extractUrl(), extractEmail(), extractPhone() - Data extraction
  • QrUtils: QR code utilities
    • getRecommendedSize() - Get recommended QR code size
    • checkDataSuitability() - Check data suitability for QR codes
    • generateBatch() - Batch QR code generation
    • compareQrData() - Compare QR code data

🔒 Hash Tools

• HashTools: Cryptographic hash functions
  • generateMD5() - MD5 hash generation
  • generateSHA1(), generateSHA224(), generateSHA256() - SHA family hashes
  • generateSHA384(), generateSHA512() - Extended SHA hashes
  • generateHash() - Generic hash generation
  • generateHMAC() - HMAC generation with various algorithms
  • generateFileHash() - File content hashing
  • compareHashes() - Hash comparison utilities
  • verifyHash() - Hash verification
  • generateSaltedHash() - Salted hash generation
  • generateSalt() - Random salt generation
  • generateTimestampedHash() - Timestamped hash generation
  • generateMultipleHashes() - Multiple hash generation
  • getHashInfo() - Hash information analysis
  • generateIteratedHash() - Iterated hash generation
  • generateHashChain() - Hash chain generation
  • generateHashWithEncoding() - Hash with custom encoding

Dependencies Added #

• http: ^1.1.0 - HTTP client for network operations
• crypto: ^3.0.3 - Cryptographic functions
• convert: ^3.1.1 - Data conversion utilities
• intl: ^0.19.0 - Internationalization support
• uuid: ^4.2.1 - UUID generation
• image: ^4.1.3 - Image processing
• qr_flutter: ^4.1.0 - QR code generation
• qr_code_scanner: ^1.0.1 - QR code scanning
• xml: ^6.3.0 - XML processing
• dns_lookup: ^2.0.0 - DNS lookup utilities
• flutter_colorpicker: ^1.0.3 - Color picker utilities

Enhanced Documentation #

• Comprehensive README: Updated with all new features and examples
• Detailed Examples: Complete example app demonstrating all utilities
• API Documentation: Full API reference for all new utilities
• Usage Guides: Step-by-step guides for each utility category

Performance Improvements #

• Optimized algorithms for all new utilities
• Efficient memory usage for large data processing
• Fast execution for all mathematical calculations
• Streamlined network operations

Breaking Changes #

• None - All v1.0.0 functionality remains intact
• New dependencies require flutter pub get after upgrade

[1.0.0+1] - 2023-12-15 #

Added #

• DateUtils: Comprehensive date utility functions

  • getCurrentDateTime() - Get current date/time in custom formats
  • stringToDate() - Convert string to DateTime with custom format support
  • dateToString() - Convert DateTime to string with custom format support
  • getDateDifference() - Calculate date differences in various units (timestamp, days, hours, minutes, seconds)
  • addDays(), addMonths(), addYears() - Date arithmetic operations
  • isLeapYear() - Leap year validation
  • getDaysInMonth() - Get number of days in a month
  • startOfDay(), endOfDay() - Get start/end of day
  • isToday(), isYesterday(), isTomorrow() - Date comparison utilities
  • getAge() - Calculate age from birth date

• ValidationUtils: Comprehensive validation functions

  • checkValidLength() - String length validation
  • checkValidUrl() - URL validation
  • checkValidPanNumber() - Indian PAN number validation
  • checkValidGSTNumber() - Indian GST number validation
  • checkValidEmail() - Email address validation
  • checkValidPhoneNumber() - Phone number validation with configurable length
  • checkValidIndianMobileNumber() - Indian mobile number validation
  • checkValidAadhaarNumber() - Indian Aadhaar validation using Verhoeff algorithm
  • checkValidCreditCardNumber() - Credit card validation using Luhn algorithm
  • checkValidPassword() - Password strength validation with configurable requirements
  • checkValidIFSCCode() - Indian IFSC code validation
  • checkValidUPIId() - UPI ID validation
  • isAlphabetsOnly(), isNumbersOnly(), isAlphanumeric() - String type validations
  • isEmpty(), isNotEmpty() - Null/empty checks

• StringUtils: String manipulation and analysis functions

  • capitalizeWords(), capitalizeFirst() - Text capitalization
  • toCamelCase(), toSnakeCase(), toKebabCase() - Case conversions
  • removeWhitespace(), removeSpecialCharacters() - Text cleaning
  • reverse() - String reversal
  • isPalindrome() - Palindrome detection
  • countOccurrences() - Substring counting
  • truncate() - String truncation with suffix support
  • generateRandomString() - Random string generation
  • maskString() - Sensitive data masking
  • extractNumbers(), extractEmails(), extractUrls() - Data extraction
  • formatCurrency() - Currency formatting
  • toSlug() - URL-friendly slug generation
  • startsWithAny(), endsWithAny() - Prefix/suffix checking

• NumberUtils: Mathematical and number formatting functions

  • formatWithCommas(), formatWithCommasDouble() - Number formatting
  • numberToWords() - Number to words conversion (Indian format)
  • toOrdinal() - Ordinal number conversion
  • roundToDecimalPlaces() - Decimal rounding
  • isEven(), isOdd(), isPrime() - Number property checks
  • factorial() - Factorial calculation
  • gcd(), lcm() - Greatest common divisor and least common multiple
  • randomInt(), randomDouble() - Random number generation
  • calculatePercentage() - Percentage calculation
  • calculateCompoundInterest(), calculateSimpleInterest() - Interest calculations
  • convertTemperature(), convertLength(), convertWeight() - Unit conversions

• FileUtils: File and path utility functions

  • getFileExtension(), getFileName(), getFileNameWithoutExtension() - File path parsing
  • getDirectoryPath() - Directory path extraction
  • hasValidExtension() - File extension validation
  • getHumanReadableFileSize() - File size formatting
  • generateUniqueFileName() - Unique file name generation
  • sanitizeFileName() - File name sanitization
  • isImageFile(), isVideoFile(), isAudioFile(), isDocumentFile() - File type detection
  • getMimeType() - MIME type identification
  • formatFilePathForDisplay() - Path formatting for display
  • isAbsolutePath() - Absolute path checking
  • joinPath(), normalizePath() - Path manipulation

• NetworkUtils: Network and URL utility functions

  • isValidIPAddress(), isValidIPv4Address(), isValidIPv6Address() - IP address validation
  • isValidMACAddress() - MAC address validation
  • extractDomain(), extractProtocol(), extractPort(), extractPath() - URL parsing
  • extractQueryParameters(), buildUrlWithQueryParams() - Query parameter handling
  • isHttps(), isHttp() - Protocol checking
  • generateRandomUserAgent() - User agent generation
  • isValidEmailDomain() - Domain validation
  • getDefaultPort() - Default port lookup
  • isValidPort(), isWellKnownPort(), isRegisteredPort(), isDynamicPort() - Port validation
  • parseHttpStatusCode() - HTTP status code parsing
  • isSuccessStatusCode(), isClientErrorStatusCode(), isServerErrorStatusCode() - Status code checking
  • generateRandomIPAddress() - Random IP generation
  • ipToInt(), intToIP() - IP address conversions

• Example App: Complete example application demonstrating all utility functions

• Comprehensive Documentation: Detailed README with usage examples and API reference

• MIT License: Open source license for maximum compatibility

Technical Details #

• Built with Flutter SDK ^3.9.2
• No external dependencies (pure Dart implementation)
• Comprehensive test coverage for all utility functions
• Indian-specific validations and formatting support
• Cross-platform compatibility (iOS, Android, Web, Desktop)

Performance #

• Optimized algorithms for validation functions
• Efficient string manipulation methods
• Memory-efficient implementations
• Fast execution for all utility functions

Documentation #

• Complete API documentation
• Usage examples for all functions
• Code comments and documentation strings
• Example app with live demonstrations