extract MigrationPlanCalculator interface

lib/Doctrine/Migrations/DependencyFactory.php

@@ -35,6 +35,7 @@
 use Doctrine\Migrations\Version\DefaultAliasResolver;
 use Doctrine\Migrations\Version\Executor;
 use Doctrine\Migrations\Version\MigrationFactory;
+use Doctrine\Migrations\Version\MigrationPlanCalculator;
 use Doctrine\Migrations\Version\MigrationStatusCalculator;
 use Doctrine\Migrations\Version\SortedMigrationPlanCalculator;
 use Doctrine\ORM\EntityManagerInterface;
@@ -303,9 +304,9 @@ public function getMigrationStatusCalculator() : MigrationStatusCalculator
         });
     }
 
-    public function getMigrationPlanCalculator() : SortedMigrationPlanCalculator
+    public function getMigrationPlanCalculator() : MigrationPlanCalculator
     {
-        return $this->getDependency(SortedMigrationPlanCalculator::class, function () : SortedMigrationPlanCalculator {
+        return $this->getDependency(SortedMigrationPlanCalculator::class, function () : MigrationPlanCalculator {
             return new SortedMigrationPlanCalculator(
                 $this->getMigrationRepository(),
                 $this->getMetadataStorage()

lib/Doctrine/Migrations/Version/MigrationPlanCalculator.php

@@ -0,0 +1,18 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Doctrine\Migrations\Version;
+
+use Doctrine\Migrations\Metadata\MigrationPlanList;
+
+/**
+ * The MigrationPlanCalculator is responsible for calculating the plan for migrating from the current
+ * version to another version.
+ */
+interface MigrationPlanCalculator
+{
+    public function getPlanForExactVersion(Version $version, string $direction) : MigrationPlanList;
+
+    public function getPlanUntilVersion(?Version $to = null) : MigrationPlanList;
+}

lib/Doctrine/Migrations/Version/SortedMigrationPlanCalculator.php

@@ -21,7 +21,7 @@
  *
  * @internal
  */
-final class SortedMigrationPlanCalculator
+final class SortedMigrationPlanCalculator implements MigrationPlanCalculator
 {
     /** @var MigrationRepository */
     private $migrationRepository;

tests/Doctrine/Migrations/Tests/Version/MigrationPlanCalculatorTest.php

@@ -13,6 +13,7 @@
 use Doctrine\Migrations\Metadata\Storage\MetadataStorage;
 use Doctrine\Migrations\MigrationRepository;
 use Doctrine\Migrations\Version\Direction;
+use Doctrine\Migrations\Version\MigrationPlanCalculator;
 use Doctrine\Migrations\Version\SortedMigrationPlanCalculator;
 use Doctrine\Migrations\Version\Version;
 use PHPUnit\Framework\MockObject\MockObject;
@@ -21,7 +22,7 @@
 
 final class MigrationPlanCalculatorTest extends TestCase
 {
-    /** @var SortedMigrationPlanCalculator */
+    /** @var MigrationPlanCalculator */
     private $migrationPlanCalculator;
 
     /** @var MockObject|MigrationRepository */