Add a helper for getting the since value.

Author: johnbillion

src/Doc.php

@@ -59,6 +59,10 @@ public function getParams(): array {
 		return $this->tags->getParams();
 	}
 
+	public function getSince(): string {
+		return $this->tags->getSince();
+	}
+
 	public function getReturnTypeString(): ?string {
 		return $this->tags->getReturnTypeString();
 	}

src/Tags.php

@@ -55,6 +55,22 @@ public function getParams(): array {
 		return $this->getByType( 'param' );
 	}
 
+	public function getSince(): string {
+		foreach ( $this->tags as $tag ) {
+			if ( $tag->getName() === 'since' ) {
+				$since = $tag->getContent();
+
+				if ( strpos( $since, 'MU' ) !== false ) {
+					$since = '3.0.0';
+				}
+
+				return $since;
+			}
+		}
+
+		return '';
+	}
+
 	/**
 	 * @return array<int, Tag>
 	 * @phpstan-return list<Tag>

tests/phpunit/HooksTest.php

@@ -91,6 +91,15 @@ public function testCanCountParams(): void {
 		self::assertSame( 2, $count );
 	}
 
+	public function testCanGetSince(): void {
+		$hooks = $this->getFilters();
+		$hook = $hooks->find( 'wp_tag_cloud' );
+
+		$since = $hook->getDoc()->getSince();
+
+		self::assertSame( '2.3.0', $since );
+	}
+
 	/**
 	 * @return array<string, array<int, string>>
 	 * @phpstan-return array{