WP_Interactivity_API::data_wp_each_processor( WP_Interactivity_API_Directives_Processor $p, string $mode, array $tag_stack )

1363	private function data_wp_each_processor( WP_Interactivity_API_Directives_Processor $p, string $mode, array &$tag_stack ) {1364		if ( 'enter' === $mode && 'TEMPLATE' === $p->get_tag() ) {1365			$entries = $this->get_directive_entries( $p, 'each' );1366			if ( count( $entries ) > 1 || empty( $entries ) ) {1367				// There should be only one `data-wp-each` directive per template tag.1368				return;1369			}1370			$entry = $entries[0];1371			if ( null !== $entry['unique_id'] ) {1372				return;1373			}1374			$item_name = isset( $entry['suffix'] ) ? $this->kebab_to_camel_case( $entry['suffix'] ) : 'item';1375			$result    = $this->evaluate( $entry );1376 1377			// Gets the content between the template tags and leaves the cursor in the closer tag.1378			$inner_content = $p->get_content_between_balanced_template_tags();1379 1380			// Checks if there is a manual server-side directive processing.1381			$template_end = 'data-wp-each: template end';1382			$p->set_bookmark( $template_end );1383			$p->next_tag();1384			$manual_sdp = $p->get_attribute( 'data-wp-each-child' );1385			$p->seek( $template_end ); // Rewinds to the template closer tag.1386			$p->release_bookmark( $template_end );1387 1388			/*1389			 * It doesn't process in these situations:1390			 * - Manual server-side directive processing.1391			 * - Empty or non-array values.1392			 * - Associative arrays because those are deserialized as objects in JS.1393			 * - Templates that contain top-level texts because those texts can't be1394			 *   identified and removed in the client.1395			 */1396			if (1397				$manual_sdp ||1398				empty( $result ) ||1399				! is_array( $result ) ||1400				! array_is_list( $result ) ||1401				! str_starts_with( trim( $inner_content ), '<' ) ||1402				! str_ends_with( trim( $inner_content ), '>' )1403			) {1404				array_pop( $tag_stack );1405				return;1406			}1407 1408			// Processes the inner content for each item of the array.1409			$processed_content = '';1410			foreach ( $result as $item ) {1411				// Creates a new context that includes the current item of the array.1412				$this->context_stack[] = array_replace_recursive(1413					end( $this->context_stack ) !== false ? end( $this->context_stack ) : array(),1414					array( $entry['namespace'] => array( $item_name => $item ) )1415				);1416 1417				// Processes the inner content with the new context.1418				$processed_item = $this->_process_directives( $inner_content );1419 1420				if ( null === $processed_item ) {1421					// If the HTML is unbalanced, stop processing it.1422					array_pop( $this->context_stack );1423					return;1424				}1425 1426				/*1427				 * Adds the `data-wp-each-child` directive to each top-level tag1428				 * rendered by this `data-wp-each` directive. The value is the1429				 * `data-wp-each` directive's namespace and path.1430				 *1431				 * Nested `data-wp-each` directives could render1432				 * `data-wp-each-child` elements at the top level as well, and1433				 * they should be overwritten.1434				 *1435				 * @since 6.9.01436				 */1437				$i = new WP_Interactivity_API_Directives_Processor( $processed_item );1438				while ( $i->next_tag() ) {1439					$i->set_attribute( 'data-wp-each-child', $entry['namespace'] . '::' . $entry['value'] );1440					$i->next_balanced_tag_closer_tag();1441				}1442				$processed_content .= $i->get_updated_html();