Code Coverage for /src/src/Grammar/TokenMatcher.php

1	<?php
2	declare( strict_types = 1 );
3
4	/**
5	* @file
6	* @license https://opensource.org/licenses/Apache-2.0 Apache-2.0
7	*/
8
9	namespace Wikimedia\CSS\Grammar;
10
11	use Wikimedia\CSS\Objects\ComponentValueList;
12	use Wikimedia\CSS\Objects\Token;
13
14	/**
15	* Matcher that matches a token of a particular type
16	* @see https://www.w3.org/TR/2024/WD-css-values-4-20240312/#component-types
17	*/
18	class TokenMatcher extends Matcher {
19	/** @var string One of the Token::T_* constants */
20	protected $type;
21
22	/** @var callable\|null Something to call to further validate the token */
23	protected $callback = null;
24
25	/**
26	* @param string $type Token type to match
27	* @param callable\|null $callback Something to call to further validate the token.
28	* bool callback( Token )
29	*/
30	public function __construct( $type, ?callable $callback = null ) {
31	$this->type = $type;
32	$this->callback = $callback;
33	}
34
35	/** @inheritDoc */
36	protected function generateMatches( ComponentValueList $values, $start, array $options ) {
37	$cv = $values[$start] ?? null;
38	if ( $cv instanceof Token && $cv->type() === $this->type &&
39	( !$this->callback \|\| ( $this->callback )( $cv ) )
40	) {
41	yield $this->makeMatch( $values, $start, $this->next( $values, $start, $options ) );
42	}
43	}
44	}