Merge branch 'develop'

* develop:
  specify next release
  call all registered cleanup callbacks instead of the last declared one
  directly open the readme

CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog
 
+## 5.1.0 - 2023-10-11
+
+### Changed
+
+- Registered cleanup callbacks for lazy `Sequence`s and `Set`s are all called now for composed structures, instead of the last one
+
 ## 5.0.0 - 2023-09-16
 
 ### Changed

README.md

@@ -6,7 +6,7 @@
 
 A set of classes to wrap PHP primitives to build immutable data.
 
-[Documentation](docs/)
+[Documentation](docs/README.md)
 
 ## Installation
 

src/RegisterCleanup.php

@@ -0,0 +1,66 @@
+<?php
+declare(strict_types = 1);
+
+namespace Innmind\Immutable;
+
+final class RegisterCleanup
+{
+    /** @var callable(): void */
+    private $cleanup;
+    private ?self $child = null;
+
+    /**
+     * @psalm-mutation-free
+     *
+     * @param callable(): void $cleanup
+     */
+    private function __construct(callable $cleanup)
+    {
+        $this->cleanup = $cleanup;
+    }
+
+    /**
+     * @param callable(): void $cleanup
+     */
+    public function __invoke(callable $cleanup): void
+    {
+        $this->cleanup = $cleanup;
+    }
+
+    /**
+     * @internal
+     * @psalm-pure
+     */
+    public static function noop(): self
+    {
+        return new self(static fn() => null);
+    }
+
+    /**
+     * @internal
+     */
+    public function push(): self
+    {
+        return $this->child = self::noop();
+    }
+
+    /**
+     * @internal
+     */
+    public function pop(): void
+    {
+        $this->child = null;
+    }
+
+    /**
+     * @internal
+     */
+    public function cleanup(): void
+    {
+        if ($this->child) {
+            $this->child->cleanup();
+        }
+
+        ($this->cleanup)();
+    }
+}

src/Sequence.php

@@ -79,7 +79,6 @@ public static function defer(\Generator $generator): self
      *
      * @template V
      * @psalm-pure
-     * @psalm-type RegisterCleanup = callable(callable(): void): void
      *
      * @param callable(RegisterCleanup): \Generator<V> $generator
      *