Add Ruby Level 1

The test cases are adapted from
https://github.com/web-platform-tests/wpt/tree/master/css/css-ruby/parsing

Bug: T277755
Change-Id: I8fef917ea050a7f3a43eafae483d5565070569c1

Author: tstarling

HISTORY.md

@@ -7,6 +7,7 @@
 * Update Color to Level 4 (2025-04-24)
 * Update Values and Units to Level 4 (WD 2024-03-12)
 * Update Display Level 3 to CR 2023-03-30
+* Add support for Ruby Level 1 (WD 2022-12-31)
 
 ## css-sanitizer 5.5.0 (2025-01-27)
 * Ensure <-token and identifiers are always separated as a security

README.md

@@ -93,6 +93,7 @@ The sanitizer recognizes the following CSS modules:
 * [Writing Modes Level 4, 2019-07-30](https://www.w3.org/TR/2019/CR-css-writing-modes-4-20190730)
 * [Selectors Level 4, 2019-02-25](https://www.w3.org/TR/2019/WD-css-pseudo-4-20190225/)
 * [Logical Properties and Values Level 1, 2018-08-27](https://www.w3.org/TR/2018/WD-css-logical-1-20180827/)
+* [Ruby Level 1, 2022-12-31](https://www.w3.org/TR/2022/WD-css-ruby-1-20221231/)
 
 And also,
 * The `touch-action` property from

src/Sanitizer/StylePropertySanitizer.php

@@ -78,6 +78,7 @@ public function __construct( MatcherFactory $matcherFactory ) {
 		$this->addKnownProperties( $this->cssMasking1( $matcherFactory ) );
 		$this->addKnownProperties( $this->cssSizing4( $matcherFactory ) );
 		$this->addKnownProperties( $this->cssLogical1( $matcherFactory ) );
+		$this->addKnownProperties( $this->cssRuby1( $matcherFactory ) );
 	}
 
 	/**
@@ -1928,4 +1929,27 @@ protected function cssLogical1( MatcherFactory $matcherFactory ) {
 		$this->cache[__METHOD__] = $props;
 		return $props;
 	}
+
+	/**
+	 * Properties for CSS Ruby Annotation Layout Module Level 1
+	 * @see https://www.w3.org/TR/2022/WD-css-ruby-1-20221231/
+	 * @param MatcherFactory $matcherFactory
+	 * @return Matcher[] Array mapping declaration names (lowercase) to Matchers for the values
+	 */
+	protected function cssRuby1( $matcherFactory ) {
+		return $this->cache[__METHOD__] ??= [
+			'ruby-position' => new Alternative( [
+				UnorderedGroup::someOf( [
+					new KeywordMatcher( 'alternate' ),
+					new KeywordMatcher( [ 'over', 'under' ] ),
+				] ),
+				new KeywordMatcher( [ 'inter-character' ] )
+			] ),
+			'ruby-merge' => new KeywordMatcher( [ 'separate', 'merge', 'auto' ] ),
+			'ruby-align' => new KeywordMatcher( [
+				'start', 'center', 'space-between', 'space-around '
+			] ),
+			'ruby-overhang' => new KeywordMatcher( [ 'auto', 'none' ] ),
+		];
+	}
 }

tests/Sanitizer/StylePropertySanitizerTest.php

@@ -596,6 +596,33 @@ public static function provideDeclarations() {
 			[ 'border-start-end-radius: 0 5px' ],
 			[ 'border-end-start-radius: 1em' ],
 			[ 'border-end-end-radius: 5px 10px' ],
+
+			// cssRuby1
+			[ 'ruby-merge: none', 'bad-value-for-property' ],
+			[ 'ruby-merge: collapse', 'bad-value-for-property' ],
+			[ 'ruby-merge: 10px', 'bad-value-for-property' ],
+			[ 'ruby-merge: merge separate', 'bad-value-for-property' ],
+			[ 'ruby-merge: merge auto', 'bad-value-for-property' ],
+			[ 'ruby-merge: auto separate', 'bad-value-for-property' ],
+			[ 'ruby-merge: separate' ],
+			[ 'ruby-merge: merge' ],
+			[ 'ruby-merge: auto' ],
+			[ 'ruby-overhang: auto none', 'bad-value-for-property' ],
+			[ 'ruby-overhang: none auto', 'bad-value-for-property' ],
+			[ 'ruby-overhang: auto auto', 'bad-value-for-property' ],
+			[ 'ruby-overhang: none none', 'bad-value-for-property' ],
+			[ 'ruby-overhang: auto 2px', 'bad-value-for-property' ],
+			[ 'ruby-overhang: none 2px', 'bad-value-for-property' ],
+			[ 'ruby-overhang: auto' ],
+			[ 'ruby-overhang: none' ],
+			[ 'ruby-position: auto', 'bad-value-for-property' ],
+			[ 'ruby-position: center', 'bad-value-for-property' ],
+			[ 'ruby-position: above', 'bad-value-for-property' ],
+			[ 'ruby-position: 10px 20px', 'bad-value-for-property' ],
+			[ 'ruby-position: over under', 'bad-value-for-property' ],
+			[ 'ruby-position: over' ],
+			[ 'ruby-position: under' ],
+			[ 'ruby-position: inter-character' ],
 		];
 	}
 }