Maintenance

- Update dependencies
- Update .php-cs-fixer.dist.php
- Refactor scripts in package.json to streamline phpcs and rector commands
- Refactor documentation and improve code consistency

Update PHPUnit bootstrap path and remove obsolete bootstrap file

Author: tomkyle

.php-cs-fixer.dist.php

@@ -1,18 +1,32 @@
 <?php
 $header = <<<EOF
-tomkyle/matomo-api-client (https://github.com/tomkyle/matomo-api-client)
+This file is part of {{name}}
+
+{{description}}
 
 For the full copyright and license information, please view the LICENSE
 file that was distributed with this source code.
 EOF;
 
+$info = json_decode(file_get_contents(__DIR__ . '/composer.json'), true);
+
+$header = trim(str_replace(
+    ['{{name}}', '{{description}}' ],
+    [$info['name'], $info['description'] ?? null],
+    $header
+));
+
+
 $finder = PhpCsFixer\Finder::create()
     ->in([
         __DIR__ . '/src',
         __DIR__ . '/tests'
     ]);
 
-return (new PhpCsFixer\Config())->setRules([
+return (new PhpCsFixer\Config())
+->setParallelConfig(PhpCsFixer\Runner\Parallel\ParallelConfigFactory::detect())
+->setFinder($finder)
+->setRules([
     '@PER-CS' => true,
 
     'header_comment' => [
@@ -21,4 +35,4 @@
         'location' => 'after_open',
         'separate' => 'both',
     ]
-])->setFinder($finder);
+]);

composer.lock

@@ -12,10 +12,10 @@
 
     "phpstan": "./vendor/bin/phpstan --no-progress analyse",
 
-    "phpcs"       : "./vendor/bin/php-cs-fixer fix --verbose --diff --dry-run",
+    "phpcs": "npm run phpcs:apply -- --dry-run",
     "phpcs:apply" : "./vendor/bin/php-cs-fixer fix --verbose --diff",
 
-    "rector": "./vendor/bin/rector process --dry-run",
+    "rector": "npm run rector:apply -- --dry-run",
     "rector:apply": "./vendor/bin/rector process",
 
     "phpunit": "./vendor/bin/phpunit",

package.json

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<phpunit xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" colors="true" stopOnFailure="true" bootstrap="tests/bootstrap.php" xsi:noNamespaceSchemaLocation="https://schema.phpunit.de/11.3/phpunit.xsd" cacheDirectory=".phpunit.cache" beStrictAboutCoverageMetadata="true">
+<phpunit xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" colors="true" stopOnFailure="true" bootstrap="vendor/autoload.php" xsi:noNamespaceSchemaLocation="https://schema.phpunit.de/11.3/phpunit.xsd" cacheDirectory=".phpunit.cache" beStrictAboutCoverageMetadata="true">
   <coverage>
     <report>
       <clover outputFile="tests/build/clover.xml"/>

phpunit.xml.dist

@@ -1,7 +1,9 @@
 <?php
 
 /**
- * tomkyle/matomo-api-client (https://github.com/tomkyle/matomo-api-client)
+ * This file is part of tomkyle/matomo-api-client
+ *
+ * Client library for interacting with the Matomo API. Supports retry logic and PSR-6 caches.
  *
  * For the full copyright and license information, please view the LICENSE
  * file that was distributed with this source code.
@@ -13,25 +15,24 @@
 
 interface DefaultsAwareInterface extends Log\LoggerAwareInterface
 {
-
     /**
      * Gets default API parameters.
      *
-     * @return array<string,string>
+     * @return array<string,mixed>
      */
     public function getDefaults(): array;
 
     /**
      * Sets default API parameters.
      *
-     * @param array<string,string> $defaults
+     * @param array<string,mixed> $defaults
      */
     public function setDefaults(array $defaults): self;
 
     /**
      * Merges new API parameters into the existing defaults.
      *
-     * @param array<string,string> $defaults
+     * @param array<string,mixed> $defaults
      */
     public function mergeDefaults(array $defaults): self;
 }