WP_Block_Parser

16class WP_Block_Parser {17	/**18	 * Input document being parsed19	 *20	 * @example "Pre-text\n<!-- wp:paragraph -->This is inside a block!<!-- /wp:paragraph -->"21	 *22	 * @since 5.0.023	 * @var string24	 */25	public $document;26 27	/**28	 * Tracks parsing progress through document29	 *30	 * @since 5.0.031	 * @var int32	 */33	public $offset;34 35	/**36	 * List of parsed blocks37	 *38	 * @since 5.0.039	 * @var WP_Block_Parser_Block[]40	 */41	public $output;42 43	/**44	 * Stack of partially-parsed structures in memory during parse45	 *46	 * @since 5.0.047	 * @var WP_Block_Parser_Frame[]48	 */49	public $stack;50 51	/**52	 * Parses a document and returns a list of block structures53	 *54	 * When encountering an invalid parse will return a best-effort55	 * parse. In contrast to the specification parser this does not56	 * return an error on invalid inputs.57	 *58	 * @since 5.0.059	 *60	 * @param string $document Input document being parsed.61	 * @return array[]62	 */63	public function parse( $document ) {64		$this->document = $document;65		$this->offset   = 0;66		$this->output   = array();67		$this->stack    = array();68 69		while ( $this->proceed() ) {70			continue;71		}72 73		return $this->output;74	}75 76	/**77	 * Processes the next token from the input document78	 * and returns whether to proceed eating more tokens79	 *80	 * This is the "next step" function that essentially81	 * takes a token as its input and decides what to do82	 * with that token before descending deeper into a83	 * nested block tree or continuing along the document84	 * or breaking out of a level of nesting.85	 *86	 * @internal87	 * @since 5.0.088	 * @return bool89	 */90	public function proceed() {91		$next_token = $this->next_token();92		list( $token_type, $block_name, $attrs, $start_offset, $token_length ) = $next_token;93		$stack_depth = count( $this->stack );94 95		// we may have some HTML soup before the next block.