add encoders to prevent css-parser bugs

Author: marmar8x

src/Encode.php

@@ -0,0 +1,111 @@
+<?php
+
+namespace Irmmr\RTLCss;
+
+use Irmmr\RTLCss\Encoder\ColorFuncsEncoder;
+use Irmmr\RTLCss\Encoder\Encoder;
+
+/**
+ * class Encode
+ *
+ * PHP-CSS-Parser have many problems with using css4 or other
+ * parsing values.
+ * This class is an unreliable class that tries to keep away items
+ * that the CSS parser cannot parse or make some changes to the original
+ * code so that it can be parsed.
+ * ! It is better not to use this class at all.
+ *
+ * @package Irmmr\RTLCss
+ */
+class Encode
+{
+    /**
+     * code holder
+     * @var string
+     */
+    protected string $code = '';
+
+    /**
+     * encoded code
+     * @var string
+     */
+    protected string $encoded = '';
+
+    /**
+     * all encoder classes name
+     *
+     * @var array
+     */
+    protected array $encoders = [
+        'color-funcs' => ColorFuncsEncoder::class
+    ];
+
+    /**
+     * all encoder classes (created)
+     *
+     * @var array
+     */
+    protected array $classes = [];
+
+    /**
+     * class constructor
+     */
+    public function __construct(string $code)
+    {
+        $this->code = $code;
+    }
+
+    /**
+     * set encoded code
+     */
+    public function setEncoded(string $encoded): void
+    {
+        foreach ($this->classes as $id => $cls) {
+            if (!$cls instanceof Encoder) {
+                continue;
+            }
+
+            $cls->setEncoded($encoded);
+        }
+    }
+
+    /**
+     * encode whole code using encode
+     *
+     * @return string
+     */
+    public function encode(): string
+    {
+        if (empty($this->encoded)) {
+            $this->encoded = $this->code;
+        }
+
+        foreach ($this->encoders as $id => $encoder) {
+            $enc = $this->classes[$id] = new $encoder($this->encoded);
+
+            $this->encoded = $enc->encode();
+        }
+
+        return $this->encoded;
+    }
+
+    /**
+     * decode whole code using decode
+     *
+     * @return string
+     */
+    public function decode(): string
+    {
+        $decoded = $this->encoded;
+
+        foreach ($this->classes as $id => $cls) {
+            if (!$cls instanceof Encoder) {
+                continue;
+            }
+
+            $decoded = $cls->decode();
+        }
+
+        return $decoded;
+    }
+}

src/Encoder/ColorFuncsEncoder.php

@@ -0,0 +1,83 @@
+<?php
+
+namespace Irmmr\RTLCss\Encoder;
+
+/**
+ * class RenderColorFuncs
+ *
+ * The CSS parser cannot correctly parse rgba, rgb, and hsl in CSS4.
+ *
+ * rgb(from hwb(120deg 10% 20%) r g calc(b + 200))
+ * rgb(from #0000FF calc(r + 40) calc(g + 40) b)
+ * rgb(255 255 255 / 50%)
+ *
+ * One of the best solutions is to gather all these functions from within
+ * the code and then add them later. I couldn't think of a better idea.
+ *
+ *
+ * @package Irmmr\RTLCss\Encoder
+ */
+class ColorFuncsEncoder extends Encoder
+{
+    // :)
+    protected const RENDER_EVAL = 'RTL_RENDER_COLOR_VAL_';
+
+    /**
+     * color pattern
+     * created by @chatgpt
+     *
+     * @var string
+     */
+    protected string $pattern = '/\b(?:rgb|rgba|hsl|hsla)\s*\(\s*((?:[^()]+|\((?:[^()]+|\([^()]*\))*\))*)\)/';
+
+    /**
+     * detect pattern
+     *
+     * @var string
+     */
+    protected string $det_pattern = '/'. self::RENDER_EVAL .'(\d+)/';
+
+    /**
+     * all color replacements
+     * @var array
+     */
+    protected array $replacement = [];
+
+    /**
+     * get encoded code
+     *
+     * @return string
+     */
+    public function encode(): string
+    {
+        $counter = 1;
+
+        $encoded = preg_replace_callback($this->pattern, function($matches) use (&$counter) {
+            $replacement = self::RENDER_EVAL . $counter;
+
+            $this->replacement[$counter] = $matches[0];
+
+            $counter ++;
+
+            return $replacement;
+        }, $this->code);
+
+        $this->encoded = $encoded;
+
+        return $encoded;
+    }
+
+    /**
+     * get decoded code
+     *
+     * @return string
+     */
+    public function decode(): string
+    {
+        return preg_replace_callback($this->det_pattern, function($matches) {
+            $index = (int) $matches[1];
+
+            return $this->replacement[$index] ?? $matches[0];
+        }, $this->encoded);
+    }
+}

src/Encoder/Encoder.php

@@ -0,0 +1,74 @@
+<?php
+
+namespace Irmmr\RTLCss\Encoder;
+
+/**
+ * abstract class Encoder
+ *
+ * @package Irmmr\RTLCss\Encoder
+ */
+abstract class Encoder
+{
+    /**
+     * code holder
+     * @var string
+     */
+    protected string $code = '';
+
+    /**
+     * encoded code
+     * @var string
+     */
+    protected string $encoded = '';
+    /**
+     * class constructor
+     */
+    public function __construct(string $code)
+    {
+        $this->code = $code;
+    }
+
+    /**
+     * get encoded code
+     *
+     * @return string
+     */
+    abstract public function encode(): string;
+
+    /**
+     * get decoded code
+     *
+     * @return string
+     */
+    abstract public function decode(): string;
+
+    /**
+     * get encoded code
+     *
+     * @return string
+     */
+    public function getEncoded(): string
+    {
+        return $this->encoded;
+    }
+
+    /**
+     * update encoded code
+     *
+     * @param  string $encoded
+     */
+    public function setEncoded(string $encoded): void
+    {
+        $this->encoded = $encoded;
+    }
+
+    /**
+     * get pure code
+     *
+     * @return string
+     */
+    public function getCode(): string
+    {
+        return $this->code;
+    }
+}