Removed Optional::toNullable method

src/Optional.php

@@ -8,7 +8,7 @@
 use Throwable;
 
 /**
  * @template T of mixed type of non-null value
  *
  * @implements JavaSe8\Optional<T>
  */
@@ -22,7 +22,7 @@
     final protected function __construct(
         protected readonly mixed $value,
     ) {
         if ($this->value !== null && !@static::isSupported($this->value)) {
             throw new InvalidArgumentException('Value is not supported.');
         }
     }
@@ -58,12 +58,12 @@
         if (static::class === Optional::class) {
             if ($value !== null) {
                 try {
                     /** @var static */
                     return TypedOptional::of($value, Optional::class);
                 } catch (Exception\CouldNotFindTypedOptionalForValue) {
                 }
             }
             /** @var static */
             return new class ($value) extends Optional {
                 protected static function isInstanceOfStatic(object $obj): bool
                 {
@@ -115,7 +115,7 @@
             $obj->ifPresent(function (mixed $objValue) use (&$equals, $strict): void {
                 $equals = match (!is_object($this->value) || $strict) {
                     true => $this->value === $objValue,
                     false => $this->value == $objValue,
                 };
             });
             return $equals ?? $this->value === null;
@@ -139,7 +139,7 @@
     }
 
     /**
      * @template U of mixed
      *
      * @param callable(T): JavaSe8\Optional<U> $mapper
      *
@@ -148,13 +148,13 @@
     public function flatMap(callable $mapper): self
     {
         if ($this->value === null) {
             /** @var self<U> */
             return Optional::empty();
         }
 
         /** @var mixed $mapped */
         $mapped = $mapper($this->value);
         /** @var self<U> */
         return match (true) {
             $mapped instanceof self => $mapped,
             $mapped instanceof JavaSe8\Optional => $mapped->isPresent() ? Optional::of($mapped->get()) : Optional::empty(),
@@ -239,7 +239,7 @@
         }
 
         if (is_string($exceptionSupplier)) {
             /** @var class-string<E> $exceptionSupplier */
             if (!class_exists($exceptionSupplier, autoload: true)) {
                 throw new InvalidArgumentException('Exception supplier must be existing class name.');
             }
@@ -259,20 +259,6 @@
         });
     }
 
-    /**
-     * @deprecated use {@see self::orElse()}
-     *
-     * @todo BC remove it
-     *
-     * Inverse of {@see self::ofNullable()}
-     *
-     * @return T|null
-     */
-    public function toNullable(): mixed
-    {
-        return $this->orElse(null);
-    }
-
     /**
      * @internal overridden by abstracts
      */

tests/OptionalTest.php

@@ -386,20 +386,6 @@ public static function dataMethodOrElseThrowWorks(): iterable
         }
     }
 
-    #[DataProvider('dataMethodToNullableWorks')]
-    public function testMethodToNullableWorks(Optional $optional, mixed $expectedValue): void
-    {
-        self::assertSame($expectedValue, $optional->toNullable());
-    }
-
-    public static function dataMethodToNullableWorks(): array
-    {
-        return self::makeDataSet([
-            [self::VALUE],
-            [null],
-        ]);
-    }
-
     private static function makeDataSet(array $args): array
     {
         return [