refactor(core): remove unsafe legacy utils

Author: ImperaZim

CHANGELOG.md

@@ -347,8 +347,13 @@ elprobe run <package>
   `PluginCdnResourcePackTrait` and `components\utils\ResourcePacks`.
   Resource-pack support should return later as a focused assets/resource-pack
   library such as `LibAssets`, not as part of `LibCommons`.
+- 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.
 - `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
+  the core filesystem direction and will be hardened rather than removed.
 - Component enable/disable notices now use PocketMine `TextFormat` constants
   instead of raw section-sign color codes in the core component logger.
 

README.md

@@ -222,6 +222,12 @@ 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
+`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
+rather than removed.
+
 Use each standalone repository for complete API documentation and examples.
 
 ## Package and standalone modes

changelogs/3.0.md

@@ -1538,9 +1538,13 @@ Reload rereads config files for future EasyLibrary operations. It does not:
   registration were removed from the active core:
   `PluginLanguageTrait`, `PluginResourcePacksTrait`,
   `PluginCdnResourcePackTrait` and `components\utils\ResourcePacks`.
+- The unused `HttpUtils` and `FunctionUtils` helpers were removed from
+  `components\utils`.
 - `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.
+- `File`, `Path`, `FileExtensionTypes` and `FileSystemException` remain part of
+  the core filesystem direction and will be hardened rather than removed.
 - Component enable/disable notices now use PocketMine `TextFormat` constants
   instead of raw section-sign color codes in `LibraryComponents`.
 
@@ -1581,6 +1585,17 @@ manifest validation, zip packaging, checksums, local registration and optional
 CDN integration. It should not be part of `LibCommons`, because resource packs
 need PocketMine lifecycle, filesystem state and server resource-pack handling.
 
+`HttpUtils` was removed because it performed synchronous HTTP through
+`file_get_contents`, which is not a good fit for PocketMine's main thread.
+`FunctionUtils` was removed because it was a global helper bound to
+`Library::getInstance()` and scheduler state, not a pure utility. Future HTTP
+work belongs in `LibHttp`; delayed callbacks should use PocketMine scheduler or
+a plugin-owned service.
+
+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.
+
 The component logging polish is intentionally small but useful for the 3.x
 cleanup: active core output should be generated through PocketMine formatting
 APIs instead of embedded formatting bytes. This keeps console output and future
@@ -1630,6 +1645,14 @@ $config = new Config($this->getDataFolder() . "settings.yml", Config::YAML, [
 ]);
 ```
 
+If old code used `HttpUtils`, move the HTTP call into your plugin for now and
+avoid blocking the main thread. If old code used `FunctionUtils`, schedule the
+task through the plugin scheduler directly:
+
+```php
+$this->getScheduler()->scheduleDelayedTask($task, 20);
+```
+
 Recommended mindset:
 
 ```text

docs/migration.md

@@ -92,12 +92,18 @@ Removed 2.x-era helpers:
 | `imperazim\components\plugin\traits\PluginResourcePacksTrait` | Plugin-owned resource-pack bootstrapping or future `LibAssets` |
 | `imperazim\components\plugin\traits\PluginCdnResourcePackTrait` | Plugin-owned CDN/resource-pack integration or future `LibAssets` + `LibHttp` |
 | `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 |
 
 The old `File` constructor no longer accepts the removed
 `imperazim\components\config\Config` wrapper. Pass a directory string and file
 metadata explicitly, or use PocketMine `Config` directly when you need a normal
 configuration file.
 
+The `File`/`Path` filesystem direction is not being removed. It remains a core
+utility area and may be renamed, moved or hardened later, but the API idea stays
+part of the EasyLibrary ecosystem.
+
 The removed resource-pack helpers used PocketMine internals and reflection.
 Do not depend on EasyLibrary core for that behavior in 3.x; keep resource-pack
 registration explicit in the plugin that owns the pack until a focused API is