From 8d9d9e0811aeaf3b4b23caea29b58ab1f31d7c00 Mon Sep 17 00:00:00 2001
From: Jon Surrell <sirreal@users.noreply.github.com>
Date: Mon, 25 Nov 2024 18:32:17 +0100
Subject: [PATCH] Add type selector class

---
 .../html-api/class-wp-css-selectors.php       | 43 +++++++++++++++++++
 1 file changed, 43 insertions(+)

diff --git a/src/wp-includes/html-api/class-wp-css-selectors.php b/src/wp-includes/html-api/class-wp-css-selectors.php
index 4ea438b95d8ce..4a6b65048b62b 100644
--- a/src/wp-includes/html-api/class-wp-css-selectors.php
+++ b/src/wp-includes/html-api/class-wp-css-selectors.php
@@ -457,3 +457,46 @@ public static function parse( string $input, int &$offset ): ?self {
 		return new self( $result );
 	}
 }
+
+final class WP_CSS_Type_Selector extends WP_CSS_Selector_Parser {
+	/**
+	 * @var string
+	 *
+	 * The type identifier string or '*'.
+	 */
+	public $ident;
+
+	private function __construct( string $ident ) {
+		$this->ident = $ident;
+	}
+
+	/**
+	 * Parse a type selector
+	 *
+	 * > <type-selector> = <wq-name> | <ns-prefix>? '*'
+	 * > <ns-prefix> = [ <ident-token> | '*' ]? '|'
+	 * > <wq-name> = <ns-prefix>? <ident-token>
+	 *
+	 * Namespaces (e.g. |div, *|div, or namespace|div) are not supported,
+	 * so this selector effectively matches * or ident.
+	 *
+	 * https://www.w3.org/TR/selectors/#grammar
+	 */
+	public static function parse( string $input, int &$offset ): ?self {
+		if ( $offset >= strlen( $input ) ) {
+			return false;
+		}
+
+		if ( '*' === $input[ $offset ] ) {
+			++$offset;
+			return new self( '*' );
+		}
+
+		$result = self::parse_ident( $input, $offset );
+		if ( null === $result ) {
+			return null;
+		}
+
+		return new self( $result );
+	}
+}