Refactor pseudo-types (#241)

Author: mspirkov

src/Types/ArrayKey.php renamed to src/PseudoTypes/ArrayKey.php

@@ -11,15 +11,17 @@
  * @link      http://phpdoc.org
  */
 
-namespace phpDocumentor\Reflection\Types;
+namespace phpDocumentor\Reflection\PseudoTypes;
 
 use phpDocumentor\Reflection\PseudoType;
 use phpDocumentor\Reflection\Type;
+use phpDocumentor\Reflection\Types\AggregatedType;
+use phpDocumentor\Reflection\Types\Compound;
+use phpDocumentor\Reflection\Types\Integer;
+use phpDocumentor\Reflection\Types\String_;
 
 /**
- * Value Object representing a array-key Type.
- *
- * A array-key Type is the supertype (but not a union) of int and string.
+ * Value Object representing the type `array-key`.
  *
  * @psalm-immutable
  */

src/PseudoTypes/ArrayShape.php

@@ -16,7 +16,6 @@
 use phpDocumentor\Reflection\PseudoType;
 use phpDocumentor\Reflection\Type;
 use phpDocumentor\Reflection\Types\Array_;
-use phpDocumentor\Reflection\Types\ArrayKey;
 use phpDocumentor\Reflection\Types\Mixed_;
 
 use function implode;

src/PseudoTypes/CallableString.php

@@ -18,7 +18,7 @@
 use phpDocumentor\Reflection\Types\String_;
 
 /**
- * Value Object representing the type 'string'.
+ * Value Object representing the type 'callable-string'.
  *
  * @psalm-immutable
  */

src/Types/ClassString.php renamed to src/PseudoTypes/ClassString.php

@@ -11,14 +11,15 @@
  * @link      http://phpdoc.org
  */
 
-namespace phpDocumentor\Reflection\Types;
+namespace phpDocumentor\Reflection\PseudoTypes;
 
 use phpDocumentor\Reflection\Fqsen;
 use phpDocumentor\Reflection\PseudoType;
 use phpDocumentor\Reflection\Type;
+use phpDocumentor\Reflection\Types\String_;
 
 /**
- * Value Object representing the type 'string'.
+ * Value Object representing the type 'class-string'.
  *
  * @psalm-immutable
  */

src/PseudoTypes/HtmlEscapedString.php

@@ -18,7 +18,7 @@
 use phpDocumentor\Reflection\Types\String_;
 
 /**
- * Value Object representing the type 'string'.
+ * Value Object representing the type 'html-escaped-string'.
  *
  * @psalm-immutable
  */

src/Types/InterfaceString.php renamed to src/PseudoTypes/InterfaceString.php

@@ -11,17 +11,19 @@
  * @link      http://phpdoc.org
  */
 
-namespace phpDocumentor\Reflection\Types;
+namespace phpDocumentor\Reflection\PseudoTypes;
 
 use phpDocumentor\Reflection\Fqsen;
+use phpDocumentor\Reflection\PseudoType;
 use phpDocumentor\Reflection\Type;
+use phpDocumentor\Reflection\Types\String_;
 
 /**
- * Value Object representing the type 'string'.
+ * Value Object representing the type `interface-string`.
  *
  * @psalm-immutable
  */
-final class InterfaceString implements Type
+final class InterfaceString extends String_ implements PseudoType
 {
     /** @var Fqsen|null */
     private $fqsen;
@@ -34,6 +36,11 @@ public function __construct(?Fqsen $fqsen = null)
         $this->fqsen = $fqsen;
     }
 
+    public function underlyingType(): Type
+    {
+        return new String_();
+    }
+
     /**
      * Returns the FQSEN associated with this object.
      */

src/PseudoTypes/KeyOf.php

@@ -15,7 +15,6 @@
 
 use phpDocumentor\Reflection\PseudoType;
 use phpDocumentor\Reflection\Type;
-use phpDocumentor\Reflection\Types\ArrayKey;
 
 /**
  * Value Object representing the `key-of` type.

src/PseudoTypes/LiteralString.php

@@ -18,7 +18,7 @@
 use phpDocumentor\Reflection\Types\String_;
 
 /**
- * Value Object representing the type 'string'.
+ * Value Object representing the type 'literal-string'.
  *
  * @psalm-immutable
  */

src/PseudoTypes/LowercaseString.php

@@ -18,7 +18,7 @@
 use phpDocumentor\Reflection\Types\String_;
 
 /**
- * Value Object representing the type 'string'.
+ * Value Object representing the type 'lowercase-string'.
  *
  * @psalm-immutable
  */

src/PseudoTypes/NonEmptyLowercaseString.php

@@ -18,7 +18,7 @@
 use phpDocumentor\Reflection\Types\String_;
 
 /**
- * Value Object representing the type 'string'.
+ * Value Object representing the type 'non-empty-lowercase-string'.
  *
  * @psalm-immutable
  */