refactor: convert PHPDoc annotations to native PHP type declarations

Converted PHPDoc type annotations to native PHP type declarations where possible:

- Added native property type to HarFileRepository::$repositoryPath
- Added native property type to TruncatingDateTimeHandler::$innerHandler
- Added missing return types to TruncatingDateTimeHandler methods (array, mixed, string)
- Added missing parameter and return types to Timings::getDns() and setDns()
- Added static return types to MessageInterface::setHeaders() and setHttpVersion()
- Updated trait implementations to use static instead of self for fluent interfaces

All changes maintain backward compatibility with PHP 8.2+ and pass existing test suite.

Author: claude

src/Handler/TruncatingDateTimeHandler.php

@@ -14,12 +14,9 @@
  */
 class TruncatingDateTimeHandler implements SubscribingHandlerInterface
 {
-    /**
-     * @var DateHandler
-     */
-    private $innerHandler;
+    private DateHandler $innerHandler;
 
-    public static function getSubscribingMethods()
+    public static function getSubscribingMethods(): array
     {
         $methods = [];
         $types = ['DateTime', 'DateTimeImmutable', 'DateInterval'];
@@ -70,17 +67,15 @@ public function deserializeDateTimeFromJson(JsonDeserializationVisitor $visitor,
     /**
      * Delegate undefined methods to the inner class.
      */
-    public function __call(string $name, array $arguments)
+    public function __call(string $name, array $arguments): mixed
     {
         return $this->innerHandler->{$name}(...$arguments);
     }
 
     /**
      * Truncate microseconds in a date to 6 digits of precision, which is the maximum PHP's DateTime supports.
-     *
-     * @return string|string[]
      */
-    public function truncateMicroseconds($data)
+    public function truncateMicroseconds(string $data): string
     {
         $microseconds = substr($data, 19);
         if (str_contains($data, '+')) {

src/MessageInterface.php

@@ -20,9 +20,9 @@ public function getHeadersSize(): int;
      */
     public function getHeaders(): array;
 
-    public function setHeaders(array $headers);
+    public function setHeaders(array $headers): static;
 
     public function getHttpVersion(): string;
 
-    public function setHttpVersion(string $version);
+    public function setHttpVersion(string $version): static;
 }

src/Repository/HarFileRepository.php

@@ -12,14 +12,9 @@
  */
 class HarFileRepository implements RepositoryInterface
 {
-    /**
-     * @var string
-     */
-    private $repositoryPath;
+    private string $repositoryPath;
 
     /**
-     * HarFileRepository constructor.
-     *
      * @param string $repositoryPath the path to the repository on disk
      */
     public function __construct(string $repositoryPath)

src/SharedFields/HeadersTrait.php

@@ -32,7 +32,7 @@ public function getHeadersSize(): int
     /**
      * @param \Deviantintegral\Har\Header[] $headers
      */
-    public function setHeaders(array $headers): self
+    public function setHeaders(array $headers): static
     {
         $this->headers = $headers;
 

src/SharedFields/HttpVersionTrait.php

@@ -13,7 +13,7 @@ trait HttpVersionTrait
      */
     private string $httpVersion;
 
-    public function setHttpVersion(string $httpVersion): self
+    public function setHttpVersion(string $httpVersion): static
     {
         $this->httpVersion = $httpVersion;
 

src/Timings.php

@@ -88,20 +88,12 @@ public function hasDns(): bool
         return -1.0 !== $this->dns;
     }
 
-    /**
-     * @return float
-     */
-    public function getDns()
+    public function getDns(): float
     {
         return $this->dns;
     }
 
-    /**
-     * @param float $dns
-     *
-     * @return Timings
-     */
-    public function setDns($dns)
+    public function setDns(float $dns): self
     {
         $this->dns = $dns;