MediaWiki 1.30.2

[autoinstallsdev/mediawiki.git] / vendor / wikimedia / css-sanitizer / src / Objects / CSSObject.php

diff --git a/vendor/wikimedia/css-sanitizer/src/Objects/CSSObject.php b/vendor/wikimedia/css-sanitizer/src/Objects/CSSObject.php
new file mode 100644 (file)
index 0000000..9a1bbcc
--- /dev/null
+++ b/vendor/wikimedia/css-sanitizer/src/Objects/CSSObject.php
@@ -0,0 +1,39 @@
+<?php
+/**
+ * @file
+ * @license https://opensource.org/licenses/Apache-2.0 Apache-2.0
+ */
+
+namespace Wikimedia\CSS\Objects;
+
+/**
+ * A base interface for "CSS objects"
+ *
+ * Each object has a position and an ability to be turned into a sequence of
+ * Tokens.
+ */
+interface CSSObject {
+       /**
+        * Get the position of this object in the input stream
+        *
+        * Position is reported as one-based line and one-based codepoint within
+        * the line. If no position is available, returns -1 for both line and
+        * position.
+        *
+        * @return array [ $line, $pos ]
+        */
+       public function getPosition();
+
+       /**
+        * Return an array of Tokens that correspond to this object.
+        * @return Token[]
+        */
+       public function toTokenArray();
+
+       /**
+        * Return an array of ComponentValues that correspond to this object.
+        * @warning Do not return any Tokens that aren't valid in a ComponentValueList.
+        * @return ComponentValue[]
+        */
+       public function toComponentValueArray();
+}