Fixed (32 bugs resolved — full audit) #

Critical / Logic Errors

• getUtcTimeFromLocal: was adding offset instead of subtracting; used floor() instead of truncate() for negative fractional offsets (e.g. UTC-5:30). Return type narrowed from DateTime? to DateTime (never null).
• isDateAfterToday: was an instance method that ignored this entirely, only checking the dateToCheck parameter. Removed the parameter — now correctly checks the receiver against today. Added injectable {DateTime? now} for testability.
• randomElement: was using DateTime.now().microsecondsSinceEpoch % length (deterministic, biased). Now uses a module-level Random instance with nextInt().
• isBetween: inclusive mode was using == instead of isAtSameMomentAs for boundary equality — boundary values were excluded.
• removeStart: case-insensitive path was calling nullIfEmpty() on the trimmed match, returning null instead of the original string on non-match.
• last(): was using rune-based indexing, splitting multi-codepoint emoji. Now uses characters package grapheme clusters. Also optimised: replaces toList() + sublist() with chars.skip() to avoid full list allocation.
• toDateInYear: was crashing with ArgumentError for Feb 29 → non-leap year. Now returns null.
• cleanJsonResponse: was unescaping \" before detecting outer quotes, corrupting strings like "hello \"world\"". Now detects outer quotes first.

Medium

• betweenResult: endOptional parameter was declared but never consulted — end-not-found always returned null. Now correctly returns the tail when endOptional: true is passed. Default changed to false to preserve backward compatibility.
• isSameDateOrAfter / isSameDateOrBefore: replaced fragile cascaded year/month/day if-chains with clean toDateOnly() + !isBefore / !isAfter.
• isJson('[]'): empty array was returning true without allowEmpty: true, inconsistent with empty object {} behaviour. Now requires allowEmpty: true for both.
• isJson colon check: was checking value.contains(':') (untrimmed) instead of trimmed.contains(':').
• formatDouble: no guard for negative decimalPlaces — toStringAsFixed would throw RangeError. Now clamps to 0–20.
• hasDecimals / formatDouble: did not guard against NaN / Infinity — NaN % 1 returns NaN (not 0). Now returns false / 'NaN' / '∞' respectively.
• unescape (HTML):   was mapped to regular space (U+0020) instead of non-breaking space (U+00A0). Fixed.
• unescape (HTML): numeric entity handler allowed surrogate codepoints (U+D800–U+DFFF) which crash jsonEncode. Now rejected with named constants _surrogateMin / _surrogateMax.
• addHyphens: accepted any 32-char string without validating hex content. Now validates with _hexOnly32Regex.
• exclude / containsAny: O(n×m) — converted to Set for O(n) lookup.
• toFlattenedList: returned null for empty outer but [] for all-empty inners. Now returns null consistently for empty results.

Low / Documentation

• isYearCurrent: hardcoded DateTime.now() made it untestable. Converted from getter to method with {DateTime? now} injectable parameter.
• isDateAfterToday / isToday etc.: same injectable now pattern applied for testability.
• weekOfYear: added warning in docs that value can be 0 or 53 at year boundaries; recommend weekNumber() for ISO 8601 compliance.
• isMidnight: now checks all time components including milliseconds and microseconds.
• leastOccurrences: corrected copy-paste doc comment that said "highest" instead of "lowest".
• formatPrecision: hardcoded toStringAsFixed(2) whole-number check now uses the actual precision parameter.
• betweenResult: improved doc to explain intentional lastIndexOf ("outermost match") design.
• between: documented special case where empty end returns the tail from start.
• takeSafe(0): documented that count == 0 returns the original list (unlike take(0)).
• weekOfYear / weekNumber(): documented ISO 8601 edge cases at year boundaries.
• num.length(): documented scientific notation behaviour for values ≥ 1e21.
• pluralize: removed length == 1 guard that incorrectly skipped single-character strings.
• forceBetween: corrected misleading dartdoc ("NOT greater than" → correctly describes clamping).
• truncateWithEllipsisPreserveWords: fixed grapheme-unsafe fallback that could split multi-codepoint emoji; now uses characters.take() for the search window.
• toMapStringDynamic: documented silent key collision behaviour when ensureUniqueKey: false.
• timeToEmoji: boundary was > instead of >= — 7:00am showed moon emoji instead of sun.

Tests #

• 3,022 tests passing (added ~40 new tests covering all fixed bugs)
• Fixed 8 pre-existing tests with incorrect expectations or wrong test names
• Removed duplicate test cases in date_time_range_utils_test.dart

[1.0.6] - 2026-01-21 #

Changed #

• Extracted magic numbers into named constants across codebase for improved code clarity and linting compliance
• Added 50+ descriptive constants with documentation to date/time, numeric, string, HTML, and UUID utilities
• Migrated date/time validation constants to public exports in date_constants.dart for cross-module reuse
• Files updated:
  • datetime/date_constants.dart - Added 15 date/time validation constants
  • datetime/date_time_range_utils.dart - Uses shared month constants
  • datetime/date_time_utils.dart - Uses shared date/time constants
  • datetime/time_emoji_utils.dart - Uses day/night hour constants
  • double/double_extensions.dart - Added percentage and base-10 constants
  • hex/hex_utils.dart - Added hex radix and max length constants
  • html/html_utils.dart - Added hex radix and Unicode limit constants
  • int/int_extensions.dart - Added base-10 constant
  • int/int_string_extensions.dart - Added ordinal number constants
  • int/int_utils.dart - Added recursion depth constant
  • string/string_search_extensions.dart - Added ASCII code constants
  • string/string_utils.dart - Added alphabet position constants
  • uuid/uuid_utils.dart - Added UUID format constants
• Resolved no_magic_number linting violations in production code

Fixed #

• DateTimeUtils.tomorrow(): Removed nullable type from minute and second parameters to fix avoid_nullable_parameters_with_default_values lint warnings

Changed #

• Rewrote README with compelling production-proven messaging
• Added before/after code comparison table
• Added real-world use cases section
• Improved About section with library origin story

Fixed #

• Fix flaky DateTime test race condition in CI

Changed #

• Fix GitHub Actions publish workflow for OIDC authentication

Changed #

• Added a banner to README.md

Changed #

• Migrated from GPL v3 to MIT license for broader adoption
• Upgraded saropa_lints from recommended to insanity tier (all 500+ rules enabled)

Added #

• Pub points badge (dynamic from pub.dev)
• Methods count badge (480+ methods)
• Coverage badge (100%)
• Organized badge assets into assets/badges/ folder

Changed #

• Replaced manually flattened lint rules with saropa_lints: ^1.1.12
• Added custom_lint: ^0.8.0 for custom lint rule support
• Configured recommended tier (~150 rules)
• Simplified analysis_options.yaml from 255 lines to 69 lines
• Removed manually flattened flutter_lints/recommended/core rules

Added #

• Base64Utils - Text compression and decompression (compressText, decompressText)
• UuidUtils - UUID validation and manipulation (isUUID, addHyphens, removeHyphens)
• HtmlUtils - HTML text processing (unescape, removeHtmlTags, toPlainText)
• DoubleExtensions - Double formatting (hasDecimals, toPercentage, formatDouble, forceBetween, toPrecision, formatPrecision)
• 103 test cases covering all new utilities

Added #

• -Version parameter for CI/CD automation in publish script
• -Branch parameter to specify target branch
• Pre-publish validation step (flutter pub publish --dry-run)
• flutter analyze step before publishing
• Working tree status check with user confirmation
• Remote sync check to prevent publishing when behind remote
• Early CHANGELOG version validation

Fixed #

• Step numbering in publish script (was skipping from 4 to 6)
• ErrorActionPreference issue with try/catch for GitHub release check

Changed #

• Dynamic package name and repo URL extraction from pubspec.yaml and git remote
• Excluded example folder from parent analysis

Added #

• isJson: allowEmpty parameter to optionally treat {} as valid JSON
• 16 test cases for JsonUtils.isJson

Changed #

• substringSafe: Now uses characters.getRange() for proper UTF-16/emoji support
• truncateWithEllipsis: Uses grapheme cluster length for accurate emoji handling
• truncateWithEllipsisPreserveWords: Uses grapheme cluster length
• lastChars: Uses grapheme cluster length
• Breaking: Indices now refer to grapheme clusters, not code units

Fixed #

• MakeListExtensions: Changed extension from T to T? for nullable types
• getUtcTimeFromLocal: Fixed incorrect documentation
• getNthWeekdayOfMonthInYear: Removed stale parameter references from docs

Removed #

• UniqueListExtensionsUniqueBy: Removed unused propertyComparer generic parameter

Changed #

• publish_pub_dev.ps1: Added idempotent handling for git tags
• publish_pub_dev.ps1: Added idempotent handling for GitHub releases
• Prevents script failures when re-running after partial completion

Fixed #

• extractCurlyBraces: Switched to non-greedy matching for correct extraction order
• removeSingleCharacterWords: Made Unicode-aware for single-letter words beyond ASCII
• replaceLineBreaks: Improved deduplication for arbitrary replacement strings
• grammarArticle: Enhanced heuristics for silent 'h', "you"-sound words, and one- prefixes
• possess: Trims input before applying trailing 's' rules

Changed #

• repeat: Optimized concatenation with StringBuffer
• lettersOnly/lowerCaseLettersOnly: Simplified to regex-based ASCII filters

Added #

• UrlExtensions.isSecure - Check if URI uses HTTPS scheme
• UrlExtensions.addQueryParameter - Add or update query parameters
• UrlExtensions.hasQueryParameter - Check if query parameter exists
• UrlExtensions.getQueryParameter - Get query parameter value
• UrlExtensions.replaceHost - Create URI with different host

Added #

• JsonUtils - JSON parsing, type conversion, and validation
• MapExtensions - Map manipulation utilities
• UrlExtensions - URI manipulation (removeQuery, fileName, isValidUrl, isValidHttpUrl, tryParse)
• StringBetweenExtensions - Content extraction (between, betweenLast, removeBetween, etc.)
• StringCharacterExtensions - Character operations (splitByCharacterCount, charAtOrNull)
• StringSearchExtensions - Search utilities (containsAnyIgnoreCase, indexOfAll, lastIndexOfPattern)
• MonthUtils, WeekdayUtils, SerialDateUtils - Date constant lookups
• DateTime extensions: mostRecentSunday, mostRecentWeekday, dayOfYear, weekOfYear, numOfWeeks, weekNumber, toSerialString, toSerialStringDay
• String extensions: removeSingleCharacterWords, removeLeadingAndTrailing, firstWord, secondWord, endsWithAny, endsWithPunctuation, isAny, extractCurlyBraces, obscureText, hasInvalidUnicode, isVowel, hasAnyDigits
• Iterable/Num extensions: randomElement, containsAll, toDoubleOrNull, toIntOrNull
• DateTimeUtils.isValidDateParts - Comprehensive date part validation
• convertDaysToYearsAndMonths - includeRemainingDays option
• 2850 tests (all passing)

Fixed #

• isBetweenRange: Properly forwards inclusive parameter
• isAnnualDateInRange: Correctly handles date ranges spanning year boundaries
• isNthDayOfMonthInRange: Cross-year range validation
• inRange and isNowInRange: Default to inclusive boundary semantics
• equalsIgnoringOrder: Correctly compares duplicate counts
• hexToInt: Case-sensitive overflow check
• toUpperLatinOnly: O(n²) → O(n) using StringBuffer
• upperCaseLettersOnly: O(n²) → O(n) using StringBuffer
• truncateWithEllipsisPreserveWords: Returns truncated content when first word exceeds cutoff
• containsIgnoreCase: Empty string is contained in any string
• convertDaysToYearsAndMonths: Improved precision using average days

Added #

• 110 new test cases for algorithm fixes

Changed #

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

Changed #

• Renamed StringFormattingAndWrappingExtensions to StringExtensions

Changed #

• Merged all string extension methods into lib/string/string_extensions.dart
• Updated imports across dependent files

Removed #

• Redundant string extension files and old test files

Added #

• Comprehensive test suite for string_extensions.dart

Added #

• Extension methods for numbers, lists, and strings (forceBetween, order-agnostic list comparison, safer string number parsing)
• Test files for new extensions

Changed #

• Refactored extension names for consistency
• Updated test imports and structures

Changed #

• Split large string file into smaller, specific files
• Updated tests and imports for new file structure
• Improved code analysis settings

Added #

• Unique lists and number ranges utilities

Added #

• Framework extensions for primitives (num, string, etc.)

Changed #

• Line length to 100

Removed #

• VGV's spelling lists

Changed #

• Minor improvements and fixes

Changed #

• Minor improvements and fixes

Changed #

• Major refactoring release

Added #

• DateTimeRange utils
• DateTime utils
• Dependency to jiffy and intl for date processing

Changed #

• Unused flutter code detection script logs warnings to file

Changed #

• Minor improvements

Changed #

• Minor improvements

Changed #

• Minor improvements

Added #

• Unused flutter code detection script
• TED talks video library to Code of Conduct

Changed #

• H.O.N.E.S.T.I. acronym wording in Code of Conduct
• Code of Conduct with Saropa logo, examples, survey, and exercise
• Link to Code of Conduct in README.md
• Renamed doc folder to docs

Removed #

• Codecov integration

Added #

• CommonRandom class as drop-in replacement for math.Random()
• Code of Conduct for Saropa contributors
• Development helper scripts

Changed #

• Updated changelog

Changed #

• Migrated List extensions to Iterable

Added #

• Enum methods: byNameTry and sortedEnumValues
• List extensions for smallest, biggest, most, and least occurrences

Changed #

• Bumped SDK requirements (sdk: ">=3.4.3 <4.0.0", flutter: ">=3.24.0")
• Added collections package dependency

Changed #

• Renamed string_nullable_utils.dart to string_nullable_extensions.dart

Deprecated #

• Several functions in preparation for removal

Added #

• DateConstants.unixEpochDate
• DateConstantExtensions.isUnixEpochDate
• DateConstantExtensions.isUnixEpochDateTime
• IntStringExtensions.ordinal
• StringUtils.getNthLatinLetterLower
• StringUtils.getNthLatinLetterUpper
• IntUtils.findGreatestCommonDenominator
• IntExtensions.countDigits

Fixed #

• StringExtensions.removeStart returns input when search param is empty

Removed #

• Deprecated functions in StringNullableExtensions

Changed #

• removeStart parameter changed to nullable

Added #

• trimFirst parameter to StringExtensions.removeStart

Added #

• trimFirst parameter to StringExtensions.nullIfEmpty

Changed #

• Renamed strings folder to singular

Deprecated #

• Nullable string extensions

Added #

• Swipe gesture properties

Added #

• Documentation for all methods
• Code usage in Example App
• Code usage in README.md
• String extension methods

Added #

• Example App
• GitHub Actions setup
• Pull request template
• Issue template
• Contributing guide

Added #

• Random enum method

Added #

• String to bool conversion methods

Added #

• Initial release with bool list methods

      Made by Saropa. All rights reserved.