refactor: address PR review feedback on docblocks and gitignore

- Remove duplicate docblocks in ClaimAccessTrait, SSOTokenGenerator,
  and SSOTestData; merge typed @return/@param into existing blocks
- Remove !/.gitignore from .gitignore (not needed)

Co-Authored-By: Opencode <opencode@noreply.opencode.ai>
Co-Authored-By: GitHub Copilot <copilot@noreply.github.com>

Author: 3 people

.gitignore

@@ -40,4 +40,3 @@ phpcs.xml
 /vendor/*
 /wpcs/*
 
-!/.gitignore

src/SSOData/ClaimAccessTrait.php

@@ -35,16 +35,11 @@ abstract protected function hasClaim(string $claim): bool;
      *
      * @return mixed
      */
-    /**
-     * @return mixed
-     */
     abstract protected function getClaim(string $claim);
+
     /**
      * Get an array of all available claims and their values.
      *
-     * @return array
-     */
-    /**
      * @return array<string, mixed>
      */
     abstract protected function getAllClaims(): array;

src/SSOTokenGenerator.php

@@ -46,11 +46,8 @@ public static function createSignedTokenFromData(string $privateKey, array $toke
 
     /**
      * @param Configuration $config
-     * @param array $tokenData
-     * @return Token
-     */
-    /**
      * @param array<string,mixed> $tokenData
+     * @return Token
      */
     private static function buildToken(Configuration $config, array $tokenData): Token
     {

test/SSOTestData.php

@@ -44,12 +44,9 @@ class SSOTestData
      * @param string|null $exp
      * @param string|null $npf
      * @param string|null $iat
-     * @return array Associative array of claims.
+     * @return array<string,mixed> Associative array of claims.
      * @throws Exception
      */
-    /**
-     * @return array<string,mixed>
-     */
     public static function getTokenData(?string $exp = '10 minutes', ?string $npf = '-1 minutes', ?string $iat = 'now'): array
     {
         $exp ??= '10 minutes';
@@ -91,10 +88,7 @@ public static function getTokenData(?string $exp = '10 minutes', ?string $npf =
     /**
      * Get accessors map for supported tokens.
      *
-     * @return array Associative array of claim accessors.
-     */
-    /**
-     * @return array<string,string>
+     * @return array<string,string> Associative array of claim accessors.
      */
     public static function getTokenAccessors(): array
     {