Release/v0.3.2

CHANGELOG.md

@@ -7,6 +7,11 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [[v0.3.2](https://github.com/The-FireHub-Project/Runtime/compare/v0.3.1...v0.3.2)] – 2026-09-29
+
+### Added
+* Upgrade PHP compatibility to 8.2 and enforce readonly properties for runtime classes by @dieselxxx
+
 ## [[v0.3.1](https://github.com/The-FireHub-Project/Runtime/compare/v0.3.0...v0.3.1)] – 2026-09-16
 
 ### Added

src/Arr/Access.php

@@ -43,7 +43,7 @@
  * without introducing domain logic, framework coupling, or additional abstraction overhead.
  * @since 1.0.0
  */
-final class Access extends NativeRuntime {
+final readonly class Access extends NativeRuntime {
 
     /**
      * ### Checks if the given key or index exists in the array
@@ -377,7 +377,7 @@
         }
 
         /** @var ($number is int<2, max> ? list<TKey> : TKey) */
         return array_rand($array, $number);
 
     }
 

src/Arr/Composition.php

@@ -7,7 +7,7 @@
  * @copyright 2026-present The FireHub Project - All rights reserved
  * @license https://opensource.org/license/Apache-2-0 Apache License, Version 2.0
  *
- * @php-version >=7.4
+ * @php-version >=8.2
  * @package Runtime
  */
 
@@ -34,7 +34,7 @@
  * without introducing domain logic, framework coupling, or additional abstraction overhead.
  * @since 1.0.0
  */
-final class Composition extends NativeRuntime {
+final readonly class Composition extends NativeRuntime {
 
     /**
      * ### Creates an array by using one array for keys and another for its values

src/Arr/Inspection.php

@@ -38,7 +38,7 @@
  * This component contains no domain logic, no framework coupling, and no business rules.
  * @since 1.0.0
  */
-final class Inspection extends NativeRuntime {
+final readonly class Inspection extends NativeRuntime {
 
     /**
      * ### Checks if all array elements satisfy a callback function

src/Arr/Math.php

@@ -7,7 +7,7 @@
  * @copyright 2026-present The FireHub Project - All rights reserved
  * @license https://opensource.org/license/Apache-2-0 Apache License, Version 2.0
  *
- * @php-version >=8.0
+ * @php-version >=8.2
  * @package Runtime
  */
 
@@ -28,7 +28,7 @@
  * without introducing domain logic, framework coupling, or additional abstraction overhead.
  * @since 1.0.0
  */
-final class Math extends NativeRuntime {
+final readonly class Math extends NativeRuntime {
 
     /**
      * ### Calculate the product of values in an array

src/Arr/Mutation.php

@@ -7,7 +7,7 @@
  * @copyright 2026-present The FireHub Project - All rights reserved
  * @license https://opensource.org/license/Apache-2-0 Apache License, Version 2.0
  *
- * @php-version >=8.0
+ * @php-version >=8.2
  * @package Runtime
  */
 
@@ -30,7 +30,7 @@
  * without introducing domain logic, framework coupling, or additional abstraction overhead.
  * @since 1.0.0
  */
-final class Mutation extends NativeRuntime {
+final readonly class Mutation extends NativeRuntime {
 
     /**
      * ### Pop the element off the end of an array

src/Arr/Ordering.php

@@ -7,7 +7,7 @@
  * @copyright 2026-present The FireHub Project - All rights reserved
  * @license https://opensource.org/license/Apache-2-0 Apache License, Version 2.0
  *
- * @php-version >=8.1
+ * @php-version >=8.2
  * @package Runtime
  */
 
@@ -41,7 +41,7 @@
  * without introducing domain logic, framework coupling, or additional abstraction overhead.
  * @since 1.0.0
  */
-final class Ordering extends NativeRuntime {
+final readonly class Ordering extends NativeRuntime {
 
     /**
      * ### Sorts array

src/Arr/Pointer.php

@@ -34,7 +34,7 @@
  * operations without introducing domain logic, framework coupling, or additional abstraction overhead.
  * @since 1.0.0
  */
-final class Pointer extends NativeRuntime {
+final readonly class Pointer extends NativeRuntime {
 
     /**
      * ### Return the current element in an array

src/Arr/SetOperation.php

@@ -7,7 +7,7 @@
  * @copyright 2026-present The FireHub Project - All rights reserved
  * @license https://opensource.org/license/Apache-2-0 Apache License, Version 2.0
  *
- * @php-version >=7.4
+ * @php-version >=8.2
  * @package Runtime
  */
 
@@ -42,7 +42,7 @@
  * without introducing domain logic, framework coupling, or additional abstraction overhead.
  * @since 1.0.0
  */
-final class SetOperation extends NativeRuntime {
+final readonly class SetOperation extends NativeRuntime {
 
     /**
      * ### Computes the difference of arrays using values for comparison

src/Arr/Structure.php

@@ -39,7 +39,7 @@
  * without introducing domain logic, framework coupling, or additional abstraction overhead.
  * @since 1.0.0
  */
-final class Structure extends NativeRuntime {
+final readonly class Structure extends NativeRuntime {
 
     /**
      * ### Split an array into chunks

src/Arr/Transform.php

@@ -7,7 +7,7 @@
  * @copyright 2026-present The FireHub Project - All rights reserved
  * @license https://opensource.org/license/Apache-2-0 Apache License, Version 2.0
  *
- * @php-version >=8.1
+ * @php-version >=8.2
  * @package Runtime
  */
 
@@ -42,7 +42,7 @@
  * operations without introducing domain logic, framework coupling, or additional abstraction overhead.
  * @since 1.0.0
  */
-final class Transform extends NativeRuntime {
+final readonly class Transform extends NativeRuntime {
 
     /**
      * ### Iteratively reduce the array to a single value using a callback function

src/Binary.php

@@ -7,7 +7,7 @@
  * @copyright 2026-present The FireHub Project - All rights reserved
  * @license https://opensource.org/license/Apache-2-0 Apache License, Version 2.0
  *
- * @php-version >=7.4
+ * @php-version >=8.2
  * @package Runtime
  */
 
@@ -28,7 +28,7 @@
  * API while preserving the behavior and semantics of the underlying PHP runtime.
  * @since 1.0.0
  */
-final class Binary extends NativeRuntime {
+final readonly class Binary extends NativeRuntime {
 
     /**
      * ### Pack data into a binary string

src/Char/MB.php

@@ -7,7 +7,7 @@
  * @copyright 2026-present The FireHub Project - All rights reserved
  * @license https://opensource.org/license/Apache-2-0 Apache License, Version 2.0
  *
- * @php-version >=8.1
+ * @php-version >=8.2
  * @package Runtime
  */
 
@@ -31,7 +31,7 @@
  * processing while preserving native PHP behavior, encoding support, and runtime performance.
  * @since 1.0.0
  */
-final class MB {
+final readonly class MB {
 
     /**
      * ### Return character by Unicode code point value

src/Char/SB.php

@@ -7,7 +7,7 @@
  * @copyright 2026-present The FireHub Project - All rights reserved
  * @license https://opensource.org/license/Apache-2-0 Apache License, Version 2.0
  *
- * @php-version >=7.0
+ * @php-version >=8.2
  * @package Runtime
  */
 
@@ -30,7 +30,7 @@
  * processing while preserving native PHP behavior, performance, and compatibility.
  * @since 1.0.0
  */
-final class SB {
+final readonly class SB {
 
     /**
      * ### Generate a single-byte string from a number

src/Constant.php

@@ -31,7 +31,7 @@
  * additional abstraction or changing PHP semantics.
  * @since 1.0.0
  */
-final class Constant extends NativeRuntime {
+final readonly class Constant extends NativeRuntime {
 
     /**
      * ### Checks whether a given named constant exists

src/Copy.php

@@ -32,7 +32,7 @@
  * Circular object references are preserved during the copy operation.
  * @since 1.0.0
  */
-final class Copy extends NativeRuntime {
+final readonly class Copy extends NativeRuntime {
 
     /**
      * ### Creates a deep copy of the given value

src/Data.php

@@ -37,7 +37,7 @@
  * without introducing domain logic, framework coupling, or additional abstraction overhead.
  * @since 1.0.0
  */
-final class Data extends NativeRuntime {
+final readonly class Data extends NativeRuntime {
 
     /**
      * ### Gets the type name of a variable in a way that is suitable for debugging

src/DataIs.php

@@ -7,7 +7,7 @@
  * @copyright 2026-present The FireHub Project - All rights reserved
  * @license https://opensource.org/license/Apache-2-0 Apache License, Version 2.0
  *
- * @php-version >=7.4
+ * @php-version >=8.2
  * @package Runtime
  */
 
@@ -39,7 +39,7 @@
  * without introducing conversion, transformation, or additional abstraction logic.
  * @since 1.0.0
  */
-final class DataIs extends NativeRuntime {
+final readonly class DataIs extends NativeRuntime {
 
     /**
      * ### Checks whether the value is an array

src/Date/Calendar.php

@@ -7,7 +7,7 @@
  * @copyright 2026-present The FireHub Project - All rights reserved
  * @license https://opensource.org/license/Apache-2-0 Apache License, Version 2.0
  *
- * @php-version >=8.0
+ * @php-version >=8.2
  * @package Runtime
  */
 
@@ -26,7 +26,7 @@
  * while preserving native runtime behavior.
  * @since 1.0.0
  */
-final class Calendar extends NativeRuntime {
+final readonly class Calendar extends NativeRuntime {
 
     /**
      * ### Check for a valid date

src/Date/Format.php

@@ -26,7 +26,7 @@
  * Provides low-level wrappers for formatting Unix timestamps into human-readable date and time representations while
  * preserving native PHP formatting behavior.
  */
-final class Format extends NativeRuntime {
+final readonly class Format extends NativeRuntime {
 
     /**
      * ### Format a Unix timestamp

src/Date/Parse.php

@@ -30,7 +30,7 @@
  * native PHP behavior.
  * @since 1.0.0
  */
-final class Parse extends NativeRuntime {
+final readonly class Parse extends NativeRuntime {
 
     /**
      * ### Returns associative array with detailed info about the given date/time

src/Date/Solar.php

@@ -7,7 +7,7 @@
  * @copyright 2026-present The FireHub Project - All rights reserved
  * @license https://opensource.org/license/Apache-2-0 Apache License, Version 2.0
  *
- * @php-version >=7.4
+ * @php-version >=8.2
  * @package Runtime
  */
 
@@ -24,7 +24,7 @@
  * PHP date functions.
  * @since 1.0.0
  */
-final class Solar extends NativeRuntime {
+final readonly class Solar extends NativeRuntime {
 
     /**
      * ### Gets information about sunset/sunrise and twilight begin/end

src/Date/Timestamp.php

@@ -26,7 +26,7 @@
  * native runtime behavior.
  * @since 1.0.0
  */
-final class Timestamp extends NativeRuntime {
+final readonly class Timestamp extends NativeRuntime {
 
     /**
      * ### Format a Unix timestamp

src/Date/Timezone.php

@@ -30,7 +30,7 @@
  * native runtime behavior.
  * @since 1.0.0
  */
-final class Timezone extends NativeRuntime {
+final readonly class Timezone extends NativeRuntime {
 
     /**
      * ### Gets the default timezone used by all date/time functions in a script

src/FileSystem/File.php

@@ -46,7 +46,7 @@
  * altering native runtime semantics.
  * @since 1.0.0
  */
-final class File extends NativeRuntime {
+final readonly class File extends NativeRuntime {
 
     /**
      * ### Checks whether a file or folder exists

src/FileSystem/Folder.php

@@ -46,7 +46,7 @@
  * altering native runtime semantics.
  * @since 1.0.0
  */
-final class Folder extends NativeRuntime {
+final readonly class Folder extends NativeRuntime {
 
     /**
      * ### Tells whether the filename is a regular folder

src/FileSystem/Link.php

@@ -37,7 +37,7 @@
  * altering native runtime semantics.
  * @since 1.0.0
  */
-final class Link extends NativeRuntime {
+final readonly class Link extends NativeRuntime {
 
     /**
      * ### Tells whether the path is a symbolic link

src/FileSystem/Metadata.php

@@ -52,7 +52,7 @@
  * altering native runtime semantics.
  * @since 1.0.0
  */
-final class Metadata extends NativeRuntime {
+final readonly class Metadata extends NativeRuntime {
 
     /**
      * ### Gets file size

src/FileSystem/Path.php

@@ -33,7 +33,7 @@
  * native runtime semantics.
  * @since 1.0.0
  */
-final class Path extends NativeRuntime {
+final readonly class Path extends NativeRuntime {
 
     /**
      * ### Returns a trailing name component of a path

src/FileSystem/Permission.php

@@ -7,7 +7,7 @@
  * @copyright 2026-present The FireHub Project - All rights reserved
  * @license https://opensource.org/license/Apache-2-0 Apache License, Version 2.0
  *
- * @php-version >=7.4
+ * @php-version >=8.2
  * @package Runtime
  */
 
@@ -29,7 +29,7 @@
  * altering native runtime semantics.
  * @since 1.0.0
  */
-final class Permission extends NativeRuntime {
+final readonly class Permission extends NativeRuntime {
 
     /**
      * ### Tells whether the path is executable