3.0.0-dev.1

Author: omar-hanafy

CHANGELOG.md

@@ -1,4 +1,47 @@
 # CHANGELOG
+## [3.0.0-dev.1]
+
+#### Added
+
+- Introduced **`Paginator`**, **`AsyncPaginator`**, and **`InfinitePaginator`** for synchronous, asynchronous, and
+  infinite scrolling pagination support.
+
+- **New `calculateAge()` method** in `DateTime` extensions to compute age from a date with a leap year check.
+
+- **Numerals:**
+
+    - `safeDivide`: Safely divides two numbers with custom handling for division by zero and zero values.
+    - `roundToNearestMultiple`, `roundUpToMultiple`, `roundDownToMultiple`: Rounds numbers to the nearest, up, or down
+      to specified multiples.
+    - `isBetween`: Checks if a number is within a specified range with optional inclusivity.
+    - `toCurrency`, `toPercent`, `toFractionString`: Converts numbers to currency, percentage, or fraction string
+      formats.
+    - `isApproximatelyEqual`, `isCloseTo`: Compares numbers within specified tolerance or delta.
+    - `scaleBetween`: Normalizes a number between specified minimum and maximum values.
+    - `isInteger`: Checks if a number is an integer.
+    - `factorial`, `gcd`, `lcm`: Calculates factorial, greatest common divisor, and least common multiple.
+    - `isPrime`, `primeFactors`: Checks for primality and calculates prime factors.
+    - `toRomanNumeral`, `toOrdinal`: Converts integers to Roman numerals or ordinal representation.
+    - `isPerfectSquare`, `isPerfectCube`, `isFibonacci`: Checks if an integer is a perfect square, cube, or Fibonacci
+      number.
+    - `isPowerOf`: Checks if an integer is a power of another number.
+    - `toBinaryString`, `toHexString`, `bitCount`: Converts integers to binary, hexadecimal, and counts set bits.
+    - `isDivisibleBy`: Checks if an integer is divisible by another number.
+
+    - **New NumbersHelper class with static methods:**
+        - Added utilities for safe division, mean, median, mode, variance, standard deviation, and percentiles.
+        - Introduced methods for GCD, checking perfect squares, and converting Roman numerals to integers.
+
+#### Changed
+
+- **Improved `tryGetX` methods in `Iterable` and `Map` extensions:** Added alternative key lookups using `altKeys` in
+  various getter methods like `getString()`, `getInt()`, etc.
+
+#### Removed
+
+- **`HttpResStatus` enum** and associated extensions were removed, replaced by new lightweight HTTP status
+  code handling methods like `toHttpStatusMessage`.
+
 ## [2.7.0]
 - **Added the `toDecimalString` method on numbers**:
   similar to `toStringAsFixed` which allows formatting numbers to a specified

example/dart_helper_utils_example.dart

@@ -1,7 +1,6 @@
 import 'package:dart_helper_utils/dart_helper_utils.dart';
 
 Future<void> main() async {
-  print(0 / 0);
   // parsing dynamic numeric list to num, int, and double.
   final list = <dynamic>[1, 2, '3', '3.1', 22.3];
 
@@ -43,11 +42,11 @@ Future<void> main() async {
   final userMail = toString1(userMap['email']);
   print('Is Valid Email: ${userMail.isValidEmail}');
 
-  // Example of using HttpResStatus
-  final status = 200.toHttpResStatus;
-  print('Status: ${status.code} - ${status.desc}');
-  print('Is Success: ${status.isSuccess}');
-  print('Is Client Error: ${status.isClientError}');
+  // Example of using the global [httpStatusMessages]
+  const httpStatusCode = 200;
+  print('Status: $httpStatusCode - ${httpStatusMessages[httpStatusCode]}');
+  print('Is Success: ${httpStatusCode.isSuccessCode}');
+  print('Is Client Error: ${httpStatusCode.isClientErrorCode}');
 
   // quickly use normal date parsing.
   print('1997-08-12 00:00:00.000'.toDateTime);
@@ -222,6 +221,19 @@ Future<void> main() async {
   print(12.10.toDecimalString(2)); // Output: 12.1
   print(12.1.toDecimalString(2, keepTrailingZeros: true)); // 12.10
   print(12.123.toDecimalString(2)); // 12.12
+
+  final age = DateTime(1997, 8, 12).calculateAge();
+  print('I am ${age.years} old!');
+
+  print(DHUTimezone.generate());
+  final palestine = DHUCountry.getByCode('ps');
+  print(palestine?.flagEmoji); // 🇵🇸
+  print(palestine?.nativeNames);
+  print(palestine?.timezones);
+
+  final timeZone = DHUTimezone.byIdentifier('Africa/Cairo');
+  print(timeZone!.abbreviation);
+  timeZone.getCountries().forEach((e) => print(e.flagEmoji));
 }
 
 // Example enum used in the map

lib/dart_helper_utils.dart

@@ -1 +1,3 @@
+library dart_helper_utils;
+
 export 'src/src.dart';