Docs: Correct return and parameter types for WP_Block_List methods.

Follow-up to [48159], [56803].

Props marian1.
Fixes #63753.

git-svn-id: https://develop.svn.wordpress.org/trunk@60618 602fd350-edb4-49c9-b593-d223f7449a82

Author: SergeyBiryukov

src/wp-includes/class-wp-block-list.php

@@ -67,7 +67,7 @@ public function __construct( $blocks, $available_context = array(), $registry =
 	 *
 	 * @link https://www.php.net/manual/en/arrayaccess.offsetexists.php
 	 *
-	 * @param string $offset Offset of block to check for.
+	 * @param int $offset Offset of block to check for.
 	 * @return bool Whether block exists.
 	 */
 	#[ReturnTypeWillChange]
@@ -82,8 +82,8 @@ public function offsetExists( $offset ) {
 	 *
 	 * @link https://www.php.net/manual/en/arrayaccess.offsetget.php
 	 *
-	 * @param string $offset Offset of block value to retrieve.
-	 * @return mixed|null Block value if exists, or null.
+	 * @param int $offset Offset of block value to retrieve.
+	 * @return WP_Block|null Block value if exists, or null.
 	 */
 	#[ReturnTypeWillChange]
 	public function offsetGet( $offset ) {
@@ -105,8 +105,8 @@ public function offsetGet( $offset ) {
 	 *
 	 * @link https://www.php.net/manual/en/arrayaccess.offsetset.php
 	 *
-	 * @param string $offset Offset of block value to set.
-	 * @param mixed  $value Block value.
+	 * @param int            $offset Offset of block value to set.
+	 * @param array|WP_Block $value  Block value.
 	 */
 	#[ReturnTypeWillChange]
 	public function offsetSet( $offset, $value ) {
@@ -124,7 +124,7 @@ public function offsetSet( $offset, $value ) {
 	 *
 	 * @link https://www.php.net/manual/en/arrayaccess.offsetunset.php
 	 *
-	 * @param string $offset Offset of block value to unset.
+	 * @param int $offset Offset of block value to unset.
 	 */
 	#[ReturnTypeWillChange]
 	public function offsetUnset( $offset ) {
@@ -150,7 +150,7 @@ public function rewind() {
 	 *
 	 * @link https://www.php.net/manual/en/iterator.current.php
 	 *
-	 * @return mixed Current element.
+	 * @return WP_Block|null Current element.
 	 */
 	#[ReturnTypeWillChange]
 	public function current() {
@@ -164,7 +164,7 @@ public function current() {
 	 *
 	 * @link https://www.php.net/manual/en/iterator.key.php
 	 *
-	 * @return mixed Key of the current element.
+	 * @return int|null Key of the current element.
 	 */
 	#[ReturnTypeWillChange]
 	public function key() {