improved types for phpstan

Author: cebe

src/Reader.php

@@ -85,7 +85,9 @@ public static function readFromJsonFile(string $fileName, string $baseType = Ope
             if (is_string($resolveReferences)) {
                 $context->mode = $resolveReferences;
             }
-            $spec->setDocumentContext($spec, new JsonPointer(''));
+            if ($spec instanceof DocumentContextInterface) {
+                $spec->setDocumentContext($spec, new JsonPointer(''));
+            }
             $spec->resolveReferences();
         }
         return $spec;
@@ -126,7 +128,9 @@ public static function readFromYamlFile(string $fileName, string $baseType = Ope
             if (is_string($resolveReferences)) {
                 $context->mode = $resolveReferences;
             }
-            $spec->setDocumentContext($spec, new JsonPointer(''));
+            if ($spec instanceof DocumentContextInterface) {
+                $spec->setDocumentContext($spec, new JsonPointer(''));
+            }
             $spec->resolveReferences();
         }
         return $spec;

src/ReferenceContext.php

@@ -238,7 +238,7 @@ public function fetchReferencedFile($uri)
      * @param JsonPointer $pointer
      * @param array $data
      * @param string|null $toType
-     * @return SpecObjectInterface|array
+     * @return SpecObjectInterface|array|null
      */
     public function resolveReferenceData($uri, JsonPointer $pointer, $data, $toType)
     {
@@ -255,7 +255,6 @@ public function resolveReferenceData($uri, JsonPointer $pointer, $data, $toType)
 
         // transitive reference
         if (isset($referencedData['$ref'])) {
-            /** @var Reference $referencedObject */
             return new Reference($referencedData, $toType);
         } else {
             /** @var SpecObjectInterface|array $referencedObject */

src/spec/Callback.php

@@ -22,12 +22,25 @@
  */
 class Callback implements SpecObjectInterface, DocumentContextInterface
 {
+    /**
+     * @var string|null
+     */
     private $_url;
+    /**
+     * @var PathItem
+     */
     private $_pathItem;
-
+    /**
+     * @var array
+     */
     private $_errors = [];
-
+    /**
+     * @var SpecObjectInterface|null
+     */
     private $_baseDocument;
+    /**
+     * @var JsonPointer|null
+     */
     private $_jsonPointer;
 
 

src/spec/Paths.php

@@ -34,10 +34,17 @@ class Paths implements SpecObjectInterface, DocumentContextInterface, ArrayAcces
      * @var (PathItem|null)[]
      */
     private $_paths = [];
-
+    /**
+     * @var array
+     */
     private $_errors = [];
-
+    /**
+     * @var SpecObjectInterface|null
+     */
     private $_baseDocument;
+    /**
+     * @var JsonPointer|null
+     */
     private $_jsonPointer;
 
 

src/spec/Reference.php

@@ -29,14 +29,33 @@
  */
 class Reference implements SpecObjectInterface, DocumentContextInterface
 {
+    /**
+     * @var string
+     */
     private $_to;
+    /**
+     * @var string
+     */
     private $_ref;
+    /**
+     * @var JsonReference|null
+     */
     private $_jsonReference;
+    /**
+     * @var ReferenceContext
+     */
     private $_context;
-
+    /**
+     * @var SpecObjectInterface|null
+     */
     private $_baseDocument;
+    /**
+     * @var JsonPointer|null
+     */
     private $_jsonPointer;
-
+    /**
+     * @var array
+     */
     private $_errors = [];
 
     /**