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

1	<?php
2	/**
3	* @file
4	* @license https://opensource.org/licenses/Apache-2.0 Apache-2.0
5	*/
6
7	namespace Wikimedia\CSS\Grammar;
8
9	use Wikimedia\CSS\Objects\ComponentValueList;
10	use Wikimedia\CSS\Objects\Token;
11
12	/**
13	* Matcher that matches one of a set of values.
14	*
15	* This is intended for matching specific <delim-token>s, but will work for
16	* other types (case-sensitively) too. For the more common case-insensitive
17	* identifier matching, use KeywordMatcher.
18	*
19	* @see https://www.w3.org/TR/2024/WD-css-values-4-20240312/#component-types
20	*/
21	class DelimMatcher extends Matcher {
22	/** @var string One of the Token::T_* constants */
23	protected $type;
24
25	/** @var string[] Values to match */
26	protected $values;
27
28	/**
29	* @param string\|string[] $values Token values to match
30	* @param array $options Options
31	* - type: (string) Token type to match. Default is Token::T_DELIM.
32	*/
33	public function __construct( $values, array $options = [] ) {
34	$options += [
35	'type' => Token::T_DELIM,
36	];
37
38	$this->values = array_map( 'strval', (array)$values );
39	$this->type = $options['type'];
40	}
41
42	/** @inheritDoc */
43	protected function generateMatches( ComponentValueList $values, $start, array $options ) {
44	$cv = $values[$start] ?? null;
45	if ( $cv instanceof Token && $cv->type() === $this->type &&
46	in_array( $cv->value(), $this->values, true )
47	) {
48	yield $this->makeMatch( $values, $start, $this->next( $values, $start, $options ) );
49	}
50	}
51	}