Add support for themes service data

Author: pavoljurov

src/DiagramGenerator/Board.php

@@ -5,6 +5,7 @@
 use DiagramGenerator\Config;
 use DiagramGenerator\Fen;
 use DiagramGenerator\Image\Storage;
+use DiagramGenerator\Image\StorageLegacy;
 use DiagramGenerator\Image\Image;
 
 /**
@@ -76,7 +77,11 @@ public function getImage()
      */
     protected function generateImage()
     {
-        $storage = new Storage($this->cacheDir, $this->pieceThemeUrl, $this->boardTextureUrl);
+        if ($this->config->hasThemeUrls()) {
+            $storage = new Storage($this->cacheDir, $this->pieceThemeUrl, $this->boardTextureUrl);
+        } else {
+            $storage = new StorageLegacy($this->cacheDir, $this->pieceThemeUrl, $this->boardTextureUrl);
+        }
         $image = new Image($storage, $this->config);
         $topPadding = $storage->getMaxPieceHeight($this->fen, $this->config) - $this->config->getSize()->getCell();
 

src/DiagramGenerator/Config.php

@@ -136,6 +136,15 @@ class Config
     #[Range(min: 0, max: 100)]
     protected $compressionQualityJpg;
 
+    /**
+     * Custom theme URLs object with board and piece URLs.
+     * Structure: { board: boardUrl, wp: pieceUrl, bp: pieceUrl, ... }
+     *
+     * @var array|null
+     */
+    #[Type('array')]
+    protected $themeUrls;
+
     /**
      * Gets the value of fen.
      *
@@ -454,6 +463,41 @@ public function setCompressionQualityJpg($compressionQualityJpg)
         return $this;
     }
 
+    /**
+     * Gets the theme URLs object.
+     *
+     * @return array|null
+     */
+    public function getThemeUrls()
+    {
+        return $this->themeUrls;
+    }
+
+    /**
+     * Sets the theme URLs object.
+     * Structure: { board: boardUrl, wp: pieceUrl, bp: pieceUrl, ... }
+     *
+     * @param array|null $themeUrls
+     *
+     * @return self
+     */
+    public function setThemeUrls($themeUrls)
+    {
+        $this->themeUrls = $themeUrls;
+
+        return $this;
+    }
+
+    /**
+     * Checks if custom theme URLs are configured.
+     *
+     * @return bool
+     */
+    public function hasThemeUrls()
+    {
+        return !empty($this->themeUrls) && is_array($this->themeUrls);
+    }
+
     public function getBorderThickness()
     {
         return (int) round($this->getSize()->getCell() / 2);

src/DiagramGenerator/Image/Image.php

@@ -18,13 +18,17 @@ class Image
     /** @var BaseImage */
     protected $image;
 
-    /** @var Storage */
+    /** @var Storage|StorageLegacy */
     protected $storage;
 
     /** @var Config */
     protected $config;
 
-    public function __construct(Storage $storage, Config $config)
+    /**
+     * @param Storage|StorageLegacy $storage
+     * @param Config $config
+     */
+    public function __construct($storage, Config $config)
     {
         $this->image = (new Decoder())->initFromGdResource(imagecreatetruecolor(1, 1));
         $this->storage = $storage;
@@ -133,13 +137,16 @@ public function drawBoardWithFigures(Fen $fen, $cellSize, $topPaddingOfCell)
     {
         $this->image = $this->drawBoard($this->storage->getBackgroundTextureImage($this->config), $cellSize, $topPaddingOfCell);
 
+        $boardHasTexture = !empty($this->config->getTexture()) || 
+                          ($this->config->hasThemeUrls() && isset($this->config->getThemeUrls()['board']));
+
         $this->drawCells(
             $this->config->getSize()->getCell(),
             $this->config->getDark(),
             $this->config->getLight(),
             $this->config->getHighlightSquaresColor(),
             $topPaddingOfCell,
-            !empty($this->config->getTexture()),
+            $boardHasTexture,
             $this->config->getHighlightSquares()
         );