chore: add optional cast support to env helper and document it

Author: KolesnikovKirill

CHANGELOG.md

@@ -2,6 +2,12 @@
 
 All significant changes to this project will be documented in this file.
 
+## [1.4.1] - 2026-01-03
+
+### Changed
+
+-   Added optional `$cast parameter to global `env()`helper to enable typed casting via`Env::getCast()`.
+
 ## [1.4.0] - 2026-01-02
 
 ### Changed

README.md

@@ -46,6 +46,7 @@ require __DIR__ . '/vendor/autoload.php';
 
 // ENV
 $env = env('APP_ENV', 'production');
+$debug = env('APP_DEBUG', false, true);
 
 // Config
 config(['app.name' => 'Codemonster']);

src/helpers/env.php

@@ -3,8 +3,8 @@
 use Codemonster\Env\Env;
 
 if (!function_exists('env')) {
-    function env(string $key, mixed $default = null): mixed
+    function env(string $key, mixed $default = null, bool $cast = false): mixed
     {
-        return Env::get($key, $default);
+        return Env::getCast($key, $default, $cast);
     }
 }