Add pslam and fixes

.circleci/config.yml

@@ -35,9 +35,10 @@ jobs:
             php --version
             composer --version
       - run:
-          name: Test setup
+          name: Static Analysis
           command: |
             cd ~/workspace/repo
+            ./vendor/bin/psalm
       - run:
           name: PHPUnit Tests
           command: |

psalm.xml

@@ -0,0 +1,55 @@
+<?xml version="1.0"?>
+<psalm
+    totallyTyped="false"
+    resolveFromConfigFile="true"
+    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+    xmlns="https://getpsalm.org/schema/config"
+    xsi:schemaLocation="https://getpsalm.org/schema/config vendor/vimeo/psalm/config.xsd"
+>
+    <projectFiles>
+        <directory name="src" />
+        <ignoreFiles>
+            <directory name="vendor" />
+        </ignoreFiles>
+    </projectFiles>
+
+    <issueHandlers>
+        <LessSpecificReturnType errorLevel="info" />
+
+        <!-- level 3 issues - slightly lazy code writing, but provably low false-negatives -->
+
+        <DeprecatedMethod errorLevel="info" />
+        <DeprecatedProperty errorLevel="info" />
+        <DeprecatedClass errorLevel="info" />
+        <DeprecatedConstant errorLevel="info" />
+        <DeprecatedFunction errorLevel="info" />
+        <DeprecatedInterface errorLevel="info" />
+        <DeprecatedTrait errorLevel="info" />
+
+        <InternalMethod errorLevel="info" />
+        <InternalProperty errorLevel="info" />
+        <InternalClass errorLevel="info" />
+
+        <MissingClosureReturnType errorLevel="info" />
+        <MissingReturnType errorLevel="info" />
+        <MissingPropertyType errorLevel="info" />
+        <InvalidDocblock errorLevel="info" />
+        <MisplacedRequiredParam errorLevel="info" />
+
+        <PropertyNotSetInConstructor errorLevel="info" />
+        <MissingConstructor errorLevel="info" />
+        <MissingClosureParamType errorLevel="info" />
+        <MissingParamType errorLevel="info" />
+
+        <RedundantCondition errorLevel="info" />
+
+        <DocblockTypeContradiction errorLevel="info" />
+        <RedundantConditionGivenDocblockType errorLevel="info" />
+
+        <UnresolvableInclude errorLevel="info" />
+
+        <RawObjectIteration errorLevel="info" />
+
+        <InvalidStringClass errorLevel="info" />
+    </issueHandlers>
+</psalm>

src/Transformer.php

@@ -52,7 +52,7 @@ public function __invoke($data) {
     /**
      * Transform a spec node.
      *
-     * @param array|array $spec The spec node to transform.
+     * @param int|string|array $spec The spec node to transform.
      * @param array $data The data to transform.
      * @param array $root The root of the data from the first call to `transform()`.
      * @param string $path The current spec path being transformed.
@@ -91,19 +91,21 @@ private function transformInternal($spec, $data, $root, string $path) {
     /**
      * Resolve a JSON reference.
      *
-     * @param string $ref The reference to resolve.
+     * @param int|string $ref The reference to resolve.
      * @param mixed $context The current data context to lookup.
      * @param mixed $root The root data context for absolute references.
      * @param bool $found Set to **true** if the reference was found or **false** otherwise.
      * @return mixed Returns the value at the reference.
      */
-    private function resolveReference(string $ref, $context, $root, bool &$found = null) {
+    private function resolveReference($ref, $context, $root, bool &$found = null) {
         $found = true;
 
         if ($ref === '') {
             return $context;
         } elseif ($ref === '/') {
             return $root;
+        } elseif (is_int($ref)) {
+            return $context[$ref];
         } elseif ($ref[0] === '/') {
             $ref = substr($ref, 1);
             $context = $root;