Request params inference from method calls on request, default request values support

[romalytvynenko]

fixes #340

[jaimyborgman]

@romalytvynenko can we extend this with having /** @default */ working for ApiResourceItems?

Like for instance:

/**
 * @property Product $resource
 */
class ProductResource extends ResourceDto
{
    public function toArray(Request $request): array
    {
        $resource = $this->resource;

        return [
            /** @format uuid */
            'id' => $resource->getId(),
            ...
            /** @default draft | ProductStatus::DRAFT */
            'status' => $resource->status,
        ];
    }
}

[romalytvynenko]

@jaimyborgman I thought to do this, but it seems like "default" is not applicable here. I feel like you need combination of @var and @example, like:

/** 
 * @var ProductStatus::DRAFT $status
 * @example draft
 */
'status' => $resource->status,

Do I understand this correctly, or @default in your opinion makes sense here?

[jaimyborgman]

@default would suit this case better since i'd like to define and let know that there is a default value for "status" instead of giving an example :)