feat: add svgDom() method

RockFrontend.module.php

@@ -5,6 +5,7 @@
 use HumanDates;
 use Latte\Engine;
 use Latte\Runtime\Html;
+use LogicException;
 use RockFrontend\Asset;
 use RockFrontend\LiveReload;
 use RockFrontend\Manifest;
@@ -2223,6 +2224,27 @@ public function svg($filename, $replacements = [])
     return $this->html($svg);
   }
 
+  /**
+   * Load svg as DOM element
+   *
+   * Usage:
+   * echo $rf->svgDom("/path/to/file.svg")->addClass("foo");
+   *
+   * @param mixed $data
+   * @return HtmlPageCrawler
+   * @throws LogicException
+   */
+  public function svgDom($data): HtmlPageCrawler
+  {
+    $str = $data;
+    if ($data instanceof Pagefiles) $data = $data->first();
+    if ($data instanceof Pagefile) {
+      $str = file_get_contents($data->filename);
+    }
+    $dom = $this->dom($str)->filter("svg")->first();
+    return $dom;
+  }
+
   /**
    * Update /site/templates/.htaccess file to block direct access
    * to latte/twig/blade/less files