X-Git-Url: https://scripts.mit.edu/gitweb/autoinstallsdev/mediawiki.git/blobdiff_plain/19e297c21b10b1b8a3acad5e73fc71dcb35db44a..6932310fd58ebef145fa01eb76edf7150284d8ea:/vendor/wikimedia/css-sanitizer/src/Sanitizer/PropertySanitizer.php

diff --git a/vendor/wikimedia/css-sanitizer/src/Sanitizer/PropertySanitizer.php b/vendor/wikimedia/css-sanitizer/src/Sanitizer/PropertySanitizer.php
new file mode 100644
index 00000000..1076e574
--- /dev/null
+++ b/vendor/wikimedia/css-sanitizer/src/Sanitizer/PropertySanitizer.php
@@ -0,0 +1,129 @@
+<?php
+/**
+ * @file
+ * @license https://opensource.org/licenses/Apache-2.0 Apache-2.0
+ */
+
+namespace Wikimedia\CSS\Sanitizer;
+
+use InvalidArgumentException;
+use Wikimedia\CSS\Grammar\Matcher;
+use Wikimedia\CSS\Grammar\NothingMatcher;
+use Wikimedia\CSS\Objects\CSSObject;
+use Wikimedia\CSS\Objects\ComponentValueList;
+use Wikimedia\CSS\Objects\Declaration;
+use Wikimedia\CSS\Util;
+
+/**
+ * Sanitizes a Declaration
+ */
+class PropertySanitizer extends Sanitizer {
+
+	/** @var Matcher[] Array mapping declaration names (lowercase) to Matchers for the values */
+	private $knownProperties = [];
+
+	/** @var Matcher|null Matcher for CSS-wide keywords */
+	private $cssWideKeywords = null;
+
+	/**
+	 * @param Matcher[] $properties Array mapping declaration names (lowercase)
+	 *  to Matchers for the values
+	 * @param Matcher $cssWideKeywordsMatcher Matcher for keywords that should
+	 *  be recognized for all known properties.
+	 */
+	public function __construct( array $properties = [], Matcher $cssWideKeywordsMatcher = null ) {
+		$this->setKnownProperties( $properties );
+		$this->setCssWideKeywordsMatcher( $cssWideKeywordsMatcher ?: new NothingMatcher );
+	}
+
+	/**
+	 * Access the list of known properties
+	 * @return Matcher[]
+	 */
+	public function getKnownProperties() {
+		return $this->knownProperties;
+	}
+
+	/**
+	 * Set the list of known properties
+	 * @param Matcher[] $properties Array mapping declaration names (lowercase)
+	 *  to Matchers for the values
+	 */
+	public function setKnownProperties( array $properties ) {
+		foreach ( $properties as $prop => $matcher ) {
+			if ( strtolower( $prop ) !== $prop ) {
+				throw new InvalidArgumentException( "Property name '$prop' must be lowercased" );
+			}
+			if ( !$matcher instanceof Matcher ) {
+				throw new InvalidArgumentException( "Value for '$prop' is not a Matcher" );
+			}
+		}
+		$this->knownProperties = $properties;
+	}
+
+	/**
+	 * Merge a list of matchers into the list of known properties
+	 * @param Matcher[] $properties Array mapping declaration names (lowercase)
+	 *  to Matchers for the values
+	 * @throws InvalidArgumentException if some property is already defined
+	 */
+	public function addKnownProperties( $props ) {
+		$dups = [];
+		foreach ( $props as $k => $v ) {
+			if ( isset( $this->knownProperties[$k] ) && $props[$k] !== $this->knownProperties[$k] ) {
+				$dups[] = $k;
+			}
+		}
+		if ( $dups ) {
+			throw new InvalidArgumentException(
+				'Duplicate definitions for properties: ' . join( ' ', $dups )
+			);
+		}
+		$this->setKnownProperties( $this->knownProperties + $props );
+	}
+
+	/**
+	 * Fetch the matcher for keywords that should be recognized for all properties.
+	 * @return Matcher
+	 */
+	public function getCssWideKeywordsMatcher() {
+		return $this->cssWideKeywords;
+	}
+
+	/**
+	 * Set the matcher for keywords that should be recognized for all properties.
+	 * @param Matcher $matcher
+	 */
+	public function setCssWideKeywordsMatcher( Matcher $matcher ) {
+		$this->cssWideKeywords = $matcher;
+	}
+
+	protected function doSanitize( CSSObject $object ) {
+		if ( !$object instanceof Declaration ) {
+			$this->sanitizationError( 'expected-declaration', $object );
+			return null;
+		}
+
+		$knownProperties = $this->getKnownProperties();
+		$name = strtolower( $object->getName() );
+		if ( !isset( $knownProperties[$name] ) ) {
+			$this->sanitizationError( 'unrecognized-property', $object );
+			return null;
+		}
+
+		$list = $object->getValue();
+		if ( !$knownProperties[$name]->match( $list, [ 'mark-significance' => true ] ) &&
+			!$this->getCssWideKeywordsMatcher()->match( $list, [ 'mark-significance' => true ] )
+		) {
+			$cv = Util::findFirstNonWhitespace( $list );
+			if ( $cv ) {
+				$this->sanitizationError( 'bad-value-for-property', $cv, [ $name ] );
+			} else {
+				$this->sanitizationError( 'missing-value-for-property', $object, [ $name ] );
+			}
+			return null;
+		}
+
+		return $object;
+	}
+}