Repeater row count and row index function.

php/blocks/class-field.php

@@ -183,6 +183,18 @@ public function cast_value( $value ) {
 				break;
 		}
 
+		if ( 'repeater' === $this->control ) {
+			/**
+			 * Repeaters contain a blank row, to prevent them from being hidden when empty.
+			 * This removes that row.
+			 */
+			if ( isset( $value['rows'] ) ) {
+				foreach ( $value['rows'] as $key => $row ) {
+					unset( $value['rows'][ $key ][''] );
+				}
+			}
+		}
+
 		return $value;
 	}
 
@@ -194,6 +206,18 @@ public function cast_value( $value ) {
 	 * @return string $value The value to echo.
 	 */
 	public function cast_value_to_string( $value ) {
+		if ( 'repeater' === $this->control ) {
+			if ( defined( 'WP_DEBUG' ) && WP_DEBUG ) {
+				return sprintf(
+					// translators: Placeholders are the opening and closing anchor tags of a link.
+					__( '⚠️ Please use Block Lab\'s %1$srepeater functions%2$s to display repeater fields in your template.', 'block-lab' ),
+					'<a href="https://getblocklab.com/docs/fields/repeater/">',
+					'</a>'
+				);
+			}
+			return '';
+		}
+
 		if ( is_array( $value ) ) {
 			return implode( ', ', $value );
 		}

php/blocks/controls/class-repeater.php

@@ -24,12 +24,13 @@ class Repeater extends Control_Abstract {
 	/**
 	 * Field variable type.
 	 *
-	 * The Repeater control is an array of objects, with each row being an object.
-	 * For example, a repeater with one row might be [ { 'example-text': 'Foo', 'example-image': 4232 } ].
+	 * The Repeater control is an array of arrays, with each row being its own array.
+	 * For example, a repeater with two rows might be:
+	 * [ 'rows': [ 0: [ 'example-text': 'Foo', 'example-image': 42 ], 1: [ 'example-text': 'Bar', 'example-image': 32 ] ] ].
 	 *
 	 * @var string
 	 */
-	public $type = 'object';
+	public $type = 'array';
 
 	/**
 	 * Repeater constructor.

php/helpers.php

@@ -150,6 +150,47 @@ function reset_block_rows( $name ) {
 	block_lab()->loop()->reset( $name );
 }
 
+/**
+ * Return the total amount of rows in a repeater.
+ *
+ * @param string $name The name of the repeater field.
+ * @return int|bool The total amount of rows. False if the repeater isn't found.
+ */
+function block_row_count( $name ) {
+	global $block_lab_attributes;
+
+	if ( ! isset( $block_lab_attributes[ $name ] ) ) {
+		return false;
+	}
+
+	if ( ! isset( $block_lab_attributes[ $name ]['rows'] ) ) {
+		return false;
+	}
+
+	return count( $block_lab_attributes[ $name ]['rows'] );
+}
+
+/**
+ * Return the index of the current repeater row.
+ *
+ * Note: The index is zero-based, which means that the first row in a repeater has
+ * an index of 0, the second row has an index of 1, and so on.
+ *
+ * @param string $name (Optional) The name of the repeater field.
+ * @return int|bool The index of the row. False if the repeater isn't found.
+ */
+function block_row_index( $name = '' ) {
+	if ( '' === $name ) {
+		$name = block_lab()->loop()->active;
+	}
+
+	if ( ! isset( block_lab()->loop()->loops[ $name ] ) ) {
+		return false;
+	}
+
+	return block_lab()->loop()->loops[ $name ];
+}
+
 /**
  * Return the value of a sub-field.
  *

tests/php/unit/blocks/controls/test-class-repeater.php

@@ -46,7 +46,7 @@ public function setUp() {
 	public function test_construct() {
 		$this->assertEquals( 'Repeater', $this->instance->label );
 		$this->assertEquals( 'repeater', $this->instance->name );
-		$this->assertEquals( 'object', $this->instance->type );
+		$this->assertEquals( 'array', $this->instance->type );
 	}
 
 	/**