fix(dev): respect escaped @type for nested parameter parsing (#8987)

Author: bshaffer

dev/src/DocFx/Node/ParameterNode.php

@@ -84,7 +84,7 @@ public function getNestedParameters(): array
         $parameterString = substr($parameterString, 1, -1);
 
         // Create an array item for each parameter.
-        $nestedParameters = explode('@type', $parameterString);
+        $nestedParameters = preg_split('/(?<!\\\\)@type/', $parameterString);
 
         // Remove the first, since that's the wrapping array param,
         // and use it for the wrapping param description

dev/tests/Unit/DocFx/NodeTest.php

@@ -43,7 +43,7 @@ public function testNestedParameters()
         $params = $method->getParameters();
 
         // Assert the parameters have been parsed
-        $this->assertCount(8, $params);
+        $this->assertCount(9, $params);
 
         // Assert parent option parameter
         $this->assertEquals('data', $params[1]->getName());
@@ -76,6 +76,13 @@ public function testNestedParameters()
             'Ensure special chars are decoded, such as alice@example.com.',
             $params[7]->getDescription()
         );
+
+        $this->assertEquals('↳ escapedType', $params[8]->getName());
+        $this->assertEquals('string', $params[8]->getType());
+        $this->assertEquals(
+            'Ensure @ is escaped, such as in \@type.',
+            $params[8]->getDescription()
+        );
     }
 
     public function testProtoRefInParameters()

dev/tests/fixtures/phpdoc/nestedparams.xml

@@ -40,6 +40,8 @@
     @type ImageContext        $imageContext  Additional context that may accompany the image.
     @type string $exampleString
           Ensure special chars are decoded, such as alice@example.com.
+    @type string $escapedType
+          Ensure @ is escaped, such as in \@type.
 }"
             variable="data"
             type="array"