fix: update listBranches docblocks in Gitea and Gogs to fix PHPStan errors

HarshMN2345 · HarshMN2345 · commit 98e2e9b2d329 · 2026-05-25T18:41:51.000+05:30
diff --git a/src/VCS/Adapter/Git/Gitea.php b/src/VCS/Adapter/Git/Gitea.php
@@ -729,7 +729,7 @@ public function getPullRequestFromBranch(string $owner, string $repositoryName,
      *
      * @param string $owner Owner of the repository
      * @param string $repositoryName Name of the repository
-     * @return array<string> Array of branch names
+     * @return array{items: array<string>, hasNext: bool, nextCursor: string|null}
      */
     public function listBranches(string $owner, string $repositoryName, int $perPage = 100, int|string|null $page = 1, string $search = ''): array
     {
diff --git a/src/VCS/Adapter/Git/Gogs.php b/src/VCS/Adapter/Git/Gogs.php
@@ -501,9 +501,9 @@ public function getCommitStatuses(string $owner, string $repositoryName, string
     /**
      * List branches
      *
-     * Gogs supports listing branches but without pagination parameters.
+     * Gogs API returns all branches in a single request (no pagination support).
      *
-     * @return array<string>
+     * @return array{items: array<string>, hasNext: bool, nextCursor: string|null}
      */
     public function listBranches(string $owner, string $repositoryName, int $perPage = 100, int|string|null $page = 1, string $search = ''): array
     {

Original file line number	Diff line number	Diff line change
`@@ -729,7 +729,7 @@ public function getPullRequestFromBranch(string $owner, string $repositoryName,`
`729`	`729`	`*`
`730`	`730`	`* @param string $owner Owner of the repository`
`731`	`731`	`* @param string $repositoryName Name of the repository`
`732`		`- * @return array<string> Array of branch names`
	`732`	`+ * @return array{items: array<string>, hasNext: bool, nextCursor: string\|null}`
`733`	`733`	`*/`
`734`	`734`	`public function listBranches(string $owner, string $repositoryName, int $perPage = 100, int\|string\|null $page = 1, string $search = ''): array`
`735`	`735`	`{`
Original file line number	Diff line number	Diff line change
`@@ -501,9 +501,9 @@ public function getCommitStatuses(string $owner, string $repositoryName, string`
`501`	`501`	`/**`
`502`	`502`	`* List branches`
`503`	`503`	`*`
`504`		`- * Gogs supports listing branches but without pagination parameters.`
	`504`	`+ * Gogs API returns all branches in a single request (no pagination support).`
`505`	`505`	`*`
`506`		`- * @return array<string>`
	`506`	`+ * @return array{items: array<string>, hasNext: bool, nextCursor: string\|null}`
`507`	`507`	`*/`
`508`	`508`	`public function listBranches(string $owner, string $repositoryName, int $perPage = 100, int\|string\|null $page = 1, string $search = ''): array`
`509`	`509`	`{`