New URI/URL Extensions #

✨ New UrlExtensions Methods

• isSecure - Check if URI uses HTTPS scheme
• addQueryParameter - Add or update query parameters (removes if value is null/empty)
• hasQueryParameter - Check if a specific query parameter exists
• getQueryParameter - Get the value of a query parameter
• replaceHost - Create a new URI with a different host

New Utility Classes & Methods #

✨ New Utility Classes

• JsonUtils - JSON parsing, type conversion, and validation (jsonDecodeToMap, jsonDecodeSafe, isJson, cleanJsonResponse, tryJsonDecode, toDateTimeJson, toDateTimeEpochJson, toBoolJson, toIntJson, toDoubleJson, toStringJson, and more)
• MapExtensions - Map manipulation (nullIfEmpty, getRandomListExcept, getChildString, getGrandchild, formatReadableString)
• UrlExtensions - URI manipulation (removeQuery, fileName, isValidUrl, isValidHttpUrl, tryParse)
• StringBetweenExtensions - Content extraction (between, betweenLast, betweenBracketsResult, removeBetween, removeBetweenAll, betweenSplit)
• StringCharacterExtensions - Character operations (splitByCharacterCount, charAtOrNull)
• StringSearchExtensions - Search utilities (containsAnyIgnoreCase, indexOfAll, lastIndexOfPattern)
• MonthUtils, WeekdayUtils, SerialDateUtils - Date constant lookups and parsing

✨ New DateTime Extensions

• mostRecentSunday, mostRecentWeekday - Find previous occurrence of a weekday
• dayOfYear, weekOfYear, numOfWeeks, weekNumber - ISO week/day calculations
• toSerialString, toSerialStringDay - Serial date formatting

✨ New String Extensions

• removeSingleCharacterWords, removeLeadingAndTrailing - Content cleanup
• firstWord, secondWord - Word extraction
• endsWithAny, endsWithPunctuation, isAny - Pattern matching
• extractCurlyBraces, obscureText - Content extraction/masking
• hasInvalidUnicode, isVowel, hasAnyDigits - Character validation

✨ New Iterable/Num Extensions

• randomElement, containsAll - Collection utilities
• toDoubleOrNull, toIntOrNull - Safe numeric conversions

✨ Enhanced DateTimeUtils

• isValidDateParts - Comprehensive date part validation
• convertDaysToYearsAndMonths - Now with includeRemainingDays option

Extended Test Coverage #

🧪 Comprehensive Test Suite

• Added 10-20 test cases for each new utility method
• Total test count: 2850 tests (all passing)

Algorithm Fixes & Improvements #

🐛 DateTime Extensions

• Fixed isBetweenRange to properly forward the inclusive parameter (was being ignored)
• Fixed isAnnualDateInRange to correctly handle date ranges spanning year boundaries (e.g., Dec-Feb ranges)
• Fixed isNthDayOfMonthInRange cross-year range validation that incorrectly rejected valid months
• Fixed inRange and isNowInRange to default to inclusive boundary semantics (more intuitive behavior)

🐛 List Extensions

• Fixed equalsIgnoringOrder to correctly compare duplicate counts (previously [1,1,2] incorrectly equaled [1,2,2])

🐛 String Extensions

• Fixed hexToInt case-sensitive overflow check (lowercase 7fffffffffffffff was incorrectly flagged as overflow)
• Fixed toUpperLatinOnly O(n²) string concatenation - now uses StringBuffer for O(n) performance
• Fixed upperCaseLettersOnly O(n²) string concatenation - now uses StringBuffer for O(n) performance
• Fixed truncateWithEllipsisPreserveWords to return truncated content when first word exceeds cutoff (instead of just ellipsis)
• Fixed containsIgnoreCase to follow standard string semantics (empty string is contained in any string)

🐛 DateTime Utils

• Improved convertDaysToYearsAndMonths precision using average days per year (365.25) and month (30.4375) to account for leap years
• Added optional includeRemainingDays parameter for more detailed output

🧪 Testing

• Added 110 new test cases covering all algorithm fixes across respective test files

🔄 Enhanced string_utils.dart to optimize final regex usages. 📚 Improved documentation and usage for CommonRandom and list generation.

0.5.2+Düsseldorf #

🧹 Rename StringFormattingAndWrappingExtensions to StringExtensions

🧩 All string extension methods for formatting, manipulation, parsing, and validation were merged into a single file: lib/string/string_extensions.dart. 🔗 Imports across dependent files were updated to point to the unified extension file. 🗑️ Redundant string extension files and their old test files were removed. 🧪 A comprehensive test suite was added for string_extensions.dart, ensuring full coverage of the consolidated functionality.

➕ New extension methods were added for numbers, lists, and strings (like forceBetween, order‑agnostic list comparison, and safer string number parsing). 🧪 Fresh test files were created to cover the new extensions, and overall test coverage has been improved. 🔄 Some extension names were refactored for consistency across the codebase. 🧹 Test imports and structures were updated to align with the refactored code.

✂️ The big file for string code was split into smaller, more specific files. ➕ New code was added for things like unique lists and number ranges. 🧹 The existing code was cleaned up, making it safer and more efficient. 🔄 The tests and imports were updated to match the new file structure. ⚙️ The code analysis settings were improved to help keep things organized.

• ✂️ Removed VGV's spelling lists as they are not inherently wrong or needed
• 📦 Many more framework extensions added for primitives (num, string, etc. )
• 📚 Changed line length to 100 foresightmobile.com
• 📚 Added then Removed dependency to intl v0.20.2 intl -- too many conflicting dependencies

• ⏰ Added boilerplate [DateTimeRange] utils
• ⏰ Added many useful boilerplate [DateTime] utils
• 📚 Added dependency to jiffy and intl for date processing
• ✅ Updated unused flutter code detection script to log warnings to a file

• ✅ Added an unused flutter code detection script Dead Code Die Hard: A Practical Guide to Identifying Orphan Flutter Methods
• 🤝 Added a video library of TED talks to the Code of Conduct
• 🚀 Removed Codecov for being annoying
• 🤝 Keep H.O.N.E.S.T.I. the acronym with new wording on Work from Home and Impossible Problems to the Code of Conduct
• 🤝 Updated Code of Conduct with the Saropa logo, examples, a survey and an exercise
• 🤝 Include a link to the Code of Conduct into README.md
• 🧹 Rename doc output folder to docs

• 🧹 Update this change log CHANGELOG.md
• 🔢 Add CommonRandom class as a drop-in replacement for math.Random() with a reliable random seed
• 🤝 Added Code of Conduct for the Saropa contributors
• 📜 Added development helper scripts - including doc generation and publishing

• 🧹 Migrated List extensions to Iterable

• 🚀 New Enum Methods: Introduced byNameTry and sortedEnumValues methods for enums to enhance searching and sorting capabilities.
• 📈 Added of list extensions for common operations such as finding the smallest, biggest, most, and least occurrences in a list.
• 🧹 Bumped medium version due to addition of collections package and sdk bumps (sdk: ">=3.4.3 <4.0.0", flutter: ">=3.24.0")

• 🧹 Bumped medium version due to deprecations and rename of "string_nullable_utils.dart" to "string_nullable_extensions.dart"

• 🗑️ Removed deprecated functions in StringNullableExtensions

• 🐛 Fixed StringExtensions.removeStart to return the input string when the search param is empty 'Hello, World!'.removeStart(''); // 'Hello, World!'

• ⚙️ Added constant DateConstants.unixEpochDate DateConstants.unixEpochDate; // January 1st, 1970

• ✨ Added function DateConstantExtensions.isUnixEpochDate DateTime.utc(1970).isUnixEpochDate; // true

• ✨ Added function DateConstantExtensions.isUnixEpochDateTime DateTime.utc(1970, 1, 1, 0, 0, 1).isUnixEpochDateTime; // false

• ✨ Added function IntStringExtensions.ordinal 101.ordinal(); // 101st

• ✨ Added function StringUtils.getNthLatinLetterLower String? StringUtils.getNthLatinLetterLower(3) // "c"

• ✨ Added function StringUtils.getNthLatinLetterUpper String? StringUtils.getNthLatinLetterUpper(4) // "D"

• ✨ Added function IntUtils.findGreatestCommonDenominator String? IntUtils.findGreatestCommonDenominator(15, 45) // 15

• ✨ Added function IntExtensions.countDigits (-12345).countDigits() // 5

• Change start to be nullable String? removeStart(String? start)

• Review of meta data
• Add trimFirst param to StringExtensions.removeStart({bool trimFirst = false,}){...}

• Review of meta data
• Add trimFirst param to StringExtensions.nullIfEmpty({bool trimFirst = true,}){...}

• Renamed strings folder to singular
• Deprecated nullable string extensions

• Added Swipe gesture properties

• Added Documentation for all methods
• Added Code Usage in Example App
• Added Code Usage in README.md
• Added String Extension Methods

• Added Example App
• Setup Github Actions
• Create Pull request template
• Create Issue template
• Create Contributing guide

• Random enum method

• String to bool conversion methods.

• Initial release with bool list methods.

      Made by Saropa. All rights reserved.