Merge branch 'release/3.4.0'

Author: lindyhopchris

CHANGELOG.md

@@ -5,6 +5,20 @@ All notable changes to this project will be documented in this file. This projec
 
 ## Unreleased
 
+## [3.4.0] - 2025-09-09
+
+### Deprecated
+
+- All identifier list classes are deprecated and will be removed in 4.0. These were not documented and are being removed
+  as they contain very limited functionality. Implementations can ship their own identifier list classes depending on
+  their unique needs. The classes deprecated are:
+    - `LazyListOfGuids`
+    - `LazyListOfIdentifiers`
+    - `LazyListOfIntegerIds`
+    - `LazyListOfStringIds`
+    - `LazyListOfUuids`
+    - `ListOfIdentifiers`
+
 ## [3.3.1] - 2025-08-10
 
 ### Fixed

composer.json

@@ -24,7 +24,8 @@
         "php": "^8.1",
         "ext-json": "*",
         "psr/log": "^1.0.1 || ^2.0 || ^3.0",
-        "ramsey/uuid": "^4.7"
+        "ramsey/uuid": "^4.7",
+        "symfony/polyfill-php84": "^1.33"
     },
     "require-dev": {
         "deptrac/deptrac": "^3.0",

deptrac.yaml

@@ -32,8 +32,13 @@ deptrac:
       collectors:
         - type: classLike
           value: Psr\\Log\\*
+    - name: Attributes
+      collectors:
+        - type: classLike
+          value: ^Deprecated$
   ruleset:
     Toolkit:
+      - Attributes
     Domain:
       - Toolkit
     Application:

phpunit.xml

@@ -11,7 +11,7 @@
          cacheDirectory=".phpunit.cache"
          backupStaticProperties="false"
          failOnWarning="true"
-         failOnDeprecation="true"
+         failOnDeprecation="false"
          failOnNotice="true"
 >
     <coverage/>

src/Toolkit/Identifiers/LazyListOfGuids.php

@@ -34,6 +34,7 @@ final class LazyListOfGuids implements LazyList
      *
      * @param Closure(): Generator<Guid>|null $source
      */
+    #[\Deprecated(since: '3.4')]
     public function __construct(?Closure $source = null)
     {
         $this->source = $source;

src/Toolkit/Identifiers/LazyListOfIdentifiers.php

@@ -31,6 +31,7 @@ final class LazyListOfIdentifiers implements LazyList
      *
      * @param Closure(): Generator<Identifier>|null $source
      */
+    #[\Deprecated(since: '3.4')]
     public function __construct(?Closure $source = null)
     {
         $this->source = $source;

src/Toolkit/Identifiers/LazyListOfIntegerIds.php

@@ -30,6 +30,7 @@ final class LazyListOfIntegerIds implements LazyList
      *
      * @param Closure(): Generator<IntegerId>|null $source
      */
+    #[\Deprecated(since: '3.4')]
     public function __construct(?Closure $source = null)
     {
         $this->source = $source;

src/Toolkit/Identifiers/LazyListOfStringIds.php

@@ -30,6 +30,7 @@ final class LazyListOfStringIds implements LazyList
      *
      * @param Closure(): Generator<StringId>|null $source
      */
+    #[\Deprecated(since: '3.4')]
     public function __construct(?Closure $source = null)
     {
         $this->source = $source;

src/Toolkit/Identifiers/LazyListOfUuids.php

@@ -31,6 +31,7 @@ final class LazyListOfUuids implements LazyList
      *
      * @param Closure(): Generator<Uuid>|null $source
      */
+    #[\Deprecated(since: '3.4')]
     public function __construct(?Closure $source = null)
     {
         $this->source = $source;

src/Toolkit/Identifiers/ListOfIdentifiers.php

@@ -29,6 +29,7 @@ final class ListOfIdentifiers implements ListIterator
      *
      * @param Identifier ...$identifiers
      */
+    #[\Deprecated(since: '3.4')]
     public function __construct(Identifier ...$identifiers)
     {
         $this->stack = array_values($identifiers);