refactor: remove legacy component utils from core

Author: ImperaZim

CHANGELOG.md

@@ -356,6 +356,16 @@ elprobe run <package>
 - Removed unused `HttpUtils` and `FunctionUtils` helpers from
   `components\utils`. HTTP should move to future async `LibHttp`; delayed
   callbacks should use PocketMine scheduler or plugin-owned services.
+- Removed the remaining pure legacy `components\utils` helpers from the core:
+  `ArrayUtils`, `Text`, `Number`, `TimeUtils` and `ValidationUtils`.
+  Supported 3.x utility code now belongs to LibCommons. Use
+  `imperazim\commons\collection\Arr`, `imperazim\commons\text\Text`,
+  `imperazim\commons\number\Number`, `imperazim\commons\time\Clock`,
+  `imperazim\commons\time\Duration`, `imperazim\commons\time\KeyCooldown` and
+  `imperazim\commons\validation\Validator` as replacements.
+- The old SQL-like `ArrayUtils::query`, `select`, `insert`, `update` and
+  `delete` APIs were intentionally not carried forward. They were too broad for
+  a commons helper and should become explicit collection code or LibDB usage.
 - `imperazim\components\filesystem\File` no longer depends on the removed
   Config wrapper; pass a directory string or use PocketMine `Config` directly.
 - `File`, `Path`, `FileExtensionTypes` and `FileSystemException` remain part of

README.md

@@ -225,7 +225,17 @@ move it to a future dedicated assets/resource-pack package such as `LibAssets`
 if the ecosystem needs one later. This does not belong in `LibCommons`, because
 resource packs require PocketMine lifecycle, files, manifests and server state.
 
-The old `HttpUtils` and `FunctionUtils` helpers were removed from
+The remaining pure `components\utils` helpers were removed from the core too:
+`ArrayUtils`, `Text`, `Number`, `TimeUtils` and `ValidationUtils`. Their stable
+3.x direction is `LibCommons`:
+`imperazim\commons\collection\Arr`, `imperazim\commons\text\Text`,
+`imperazim\commons\number\Number`, `imperazim\commons\time\Clock`,
+`imperazim\commons\time\Duration`, `imperazim\commons\time\KeyCooldown` and
+`imperazim\commons\validation\Validator`. The old SQL-like `ArrayUtils::query`,
+`select`, `insert`, `update` and `delete` helpers were intentionally not ported;
+use LibDB or explicit collection code instead.
+
+The old `HttpUtils` and `FunctionUtils` helpers were also removed from
 `components\utils`. Use a future async `LibHttp` for HTTP work and PocketMine's
 scheduler or plugin-owned services for delayed callbacks. The `File` filesystem
 utility remains part of the EasyLibrary core direction and will be refined

changelogs/3.0.md

@@ -1540,6 +1540,16 @@ Reload rereads config files for future EasyLibrary operations. It does not:
   `PluginCdnResourcePackTrait` and `components\utils\ResourcePacks`.
 - The unused `HttpUtils` and `FunctionUtils` helpers were removed from
   `components\utils`.
+- The remaining pure legacy utility helpers were removed from
+  `components\utils` as well:
+  `ArrayUtils`, `Text`, `Number`, `TimeUtils` and `ValidationUtils`.
+  Their 3.x replacement is LibCommons, using focused namespaces such as
+  `imperazim\commons\collection`, `imperazim\commons\text`,
+  `imperazim\commons\number`, `imperazim\commons\time` and
+  `imperazim\commons\validation`.
+- The old SQL-like `ArrayUtils::query`, `select`, `insert`, `update` and
+  `delete` helpers were intentionally not ported to LibCommons. Use LibDB or
+  explicit collection code instead.
 - `imperazim\components\filesystem\File` no longer depends on the removed
   Config wrapper. New code should pass a directory string and file metadata, or
   use PocketMine `Config` directly for normal config files.
@@ -1596,6 +1606,21 @@ need PocketMine lifecycle, filesystem state and server resource-pack handling.
 work belongs in `LibHttp`; delayed callbacks should use PocketMine scheduler or
 a plugin-owned service.
 
+The remaining pure utility classes were moved out of the core because
+EasyLibrary 3.x is a manager, not a general-purpose utility bundle. Keeping
+`ArrayUtils`, `Text`, `Number`, `TimeUtils` and `ValidationUtils` in the core
+would recreate the old full-bundle expectation in a smaller shape. LibCommons
+is the correct owner for these helpers because it can be installed as a normal
+official package, versioned independently and reused by standalone libraries
+without implying that EasyLibrary core owns every helper API.
+
+The SQL-like `ArrayUtils` methods were not moved because their behavior looked
+database-shaped but operated on arbitrary arrays through regex parsing. That is
+too surprising for a commons package and too weak for real persistence. In 3.x,
+database-shaped data should use LibDB, while in-memory array transformations
+should be written explicitly with `Arr::pluck`, `Arr::groupBy`,
+`Arr::sortBy`, `array_filter`, `array_map` or small local domain code.
+
 The filesystem area is different: `File` and `Path` are actively useful to the
 core and remain part of the EasyLibrary direction. They may be renamed, moved or
 hardened, but the idea should stay available.
@@ -1668,6 +1693,59 @@ task through the plugin scheduler directly:
 $this->getScheduler()->scheduleDelayedTask($task, 20);
 ```
 
+If old code used the remaining `components\utils` classes, install LibCommons
+and import the focused replacement:
+
+```php
+use imperazim\commons\collection\Arr;
+use imperazim\commons\number\Number;
+use imperazim\commons\text\Text;
+use imperazim\commons\time\Clock;
+use imperazim\commons\time\Duration;
+use imperazim\commons\validation\Validator;
+
+$names = Arr::pluck($users, "name");
+$message = Text::colorize("&aOnline");
+$coins = Number::compact(15320);
+$now = Clock::time();
+$seconds = Duration::parse("10m");
+$validName = Validator::minecraftUsername("Steve_01");
+```
+
+Common method migrations:
+
+| 2.x helper | 3.x direction |
+|---|---|
+| `ArrayUtils::pluck($rows, "name")` | `Arr::pluck($rows, "name")` |
+| `ArrayUtils::flatten($array)` | `Arr::flatten($array)` |
+| `ArrayUtils::groupBy($rows, "rank")` | `Arr::groupBy($rows, "rank")` |
+| `Text::insertLineBreaks($text, 36)` | `Text::wrapWords($text, 36)` |
+| `Text::removeExtraSpaces($text)` | `Text::normalizeSpaces($text)` |
+| `Text::toUpperCase($text)` | `Text::upper($text)` |
+| `Text::toLowerCase($text)` | `Text::lower($text)` |
+| `Text::titleCase($text)` | `Text::title($text)` |
+| `Text::slugify($text)` | `Text::slug($text)` |
+| `Text::colorize($text)` | `Text::colorize($text)` |
+| `Number::formatAsCurrency($value)` | `Number::currency($value)` |
+| `Number::formatAsPercentage($ratio)` | `Number::percent($ratio)` |
+| `Number::format($length, $number)` | `Number::pad($number, $length)` |
+| `Number::max($numbers)` | `Number::maxOrNull($numbers)` |
+| `Number::min($numbers)` | `Number::minOrNull($numbers)` |
+| `TimeUtils::GetCurrentTime()` | `Clock::time()` |
+| `TimeUtils::GetCurrentDate()` | `Clock::date()` |
+| `TimeUtils::IsWeekend()` | `Clock::isWeekend()` |
+| `TimeUtils::IsLeapYear()` | `Clock::isLeapYear()` |
+| `ValidationUtils::isEmail($value)` | `Validator::email($value)` |
+| `ValidationUtils::isUrl($value)` | `Validator::url($value)` |
+| `ValidationUtils::isInteger($value)` | `Validator::integer($value)` |
+| `ValidationUtils::isMinecraftUsername($value)` | `Validator::minecraftUsername($value)` |
+| `ValidationUtils::isIpAddress($value)` | `Validator::ip($value)` |
+
+The phone-number validator and generic `Text::substring`, `Text::reverse` or
+`Text::stripHtmlTags` style helpers were not copied as-is. Use native PHP
+functions or plugin-local validation for those cases unless they become common
+enough to justify a focused LibCommons addition later.
+
 Recommended mindset:
 
 ```text

docs/migration.md

@@ -94,6 +94,11 @@ Removed 2.x-era helpers:
 | `imperazim\components\utils\ResourcePacks` | Plugin-owned resource-pack registration or future `LibAssets` |
 | `imperazim\components\utils\HttpUtils` | Future async `LibHttp` or plugin-owned HTTP client |
 | `imperazim\components\utils\FunctionUtils` | PocketMine scheduler directly or plugin-owned service |
+| `imperazim\components\utils\ArrayUtils` | `imperazim\commons\collection\Arr` for collection helpers; LibDB or explicit code for query/update behavior |
+| `imperazim\components\utils\Text` | `imperazim\commons\text\Text` |
+| `imperazim\components\utils\Number` | `imperazim\commons\number\Number` |
+| `imperazim\components\utils\TimeUtils` | `imperazim\commons\time\Clock`, `Duration` or `KeyCooldown` |
+| `imperazim\components\utils\ValidationUtils` | `imperazim\commons\validation\Validator` |
 
 The old `File` constructor no longer accepts the removed
 `imperazim\components\config\Config` wrapper. Pass a directory string and file
@@ -110,6 +115,49 @@ registration explicit in the plugin that owns the pack until a focused API is
 designed. If this becomes an official library, it should be a dedicated
 assets/resource-pack package such as `LibAssets`, not `LibCommons`.
 
+Pure utility migration now points to LibCommons. The new API uses smaller
+focused classes instead of a broad `components\utils` namespace:
+
+```php
+use imperazim\commons\collection\Arr;
+use imperazim\commons\number\Number;
+use imperazim\commons\text\Text;
+use imperazim\commons\time\Clock;
+use imperazim\commons\time\Duration;
+use imperazim\commons\validation\Validator;
+
+$names = Arr::pluck($players, "name");
+$message = Text::colorize("&aWelcome");
+$coins = Number::compact(15320);
+$now = Clock::time();
+$cooldown = Duration::parse("5m");
+$valid = Validator::minecraftUsername("Steve_01");
+```
+
+The old SQL-like `ArrayUtils` methods are not part of LibCommons:
+
+```php
+ArrayUtils::query("SELECT name FROM users WHERE age > 20", $data);
+ArrayUtils::insert("INSERT INTO users (id, name) VALUES (1, 'Alice')", $data);
+ArrayUtils::update("UPDATE users SET name = 'Bob' WHERE id = 1", $data);
+ArrayUtils::delete("DELETE FROM users WHERE id = 1", $data);
+```
+
+Those helpers were convenient but too vague for a shared commons package. Use
+LibDB when the data is database-shaped, or write explicit collection code when
+the data is already an in-memory array:
+
+```php
+use imperazim\commons\collection\Arr;
+
+$adults = array_values(array_filter(
+    $users,
+    static fn(array $user): bool => ((int) ($user["age"] ?? 0)) > 20
+));
+
+$names = Arr::pluck($adults, "name");
+```
+
 For plugin code, prefer normal PMMP dependency declarations instead of assuming
 EasyLibrary always ships a class: