Merge remote-tracking branch 'origin/dev'

Author: BernhardBaumrock

classes/FilenameArray.php

@@ -179,6 +179,7 @@ public function remove($file): self
   public function save(
     string $to,
     bool $onlyIfChanged = true,
+    bool $sourceMap = false,
   ): self {
     $dst = rockdevtools()->toPath($to);
 
@@ -188,8 +189,8 @@ public function save(
     // make sure the folder exists
     wire()->files->mkdir(dirname($dst), true);
 
-    if ($this instanceof LessArray) $this->saveLESS($dst);
-    if ($this instanceof ScssArray) $this->saveSCSS($dst);
+    if ($this instanceof LessArray) $this->saveLESS($dst, sourceMap: $sourceMap);
+    if ($this instanceof ScssArray) $this->saveSCSS($dst, sourceMap: $sourceMap);
     if ($this instanceof CssArray) $this->saveCSS($dst);
     if ($this instanceof JsArray) $this->saveJS($dst);
 

classes/LessArray.php

@@ -9,10 +9,11 @@
 
 class LessArray extends FilenameArray
 {
-  public function saveLESS(string $dst): void
+  public function saveLESS(string $dst, bool $sourceMap = false): void
   {
     /** @var Less $less */
     $less = wire()->modules->get('Less');
+    $less->setOption('sourceMap', $sourceMap);
     foreach ($this as $file) $less->addFile($file);
     $css = $less->getCss();
     $css = rockdevtools()->rockcss()->compile($css);

classes/LiveReload.php

@@ -4,6 +4,7 @@
 
 use Nette\Utils\FileInfo;
 use ProcessWire\HookEvent;
+use ProcessWire\Page;
 use ProcessWire\Wire;
 use Tracy\Debugger;
 
@@ -29,10 +30,16 @@ public function addBlueScreenPanel(): void
     });
   }
 
+  public function ___addLiveReload(Page $p): bool
+  {
+    return true;
+  }
+
   protected function addLiveReloadMarkup(HookEvent $event): void
   {
     if (wire()->config->ajax) return;
     if (wire()->config->external) return;
+    if (!$this->addLiveReload($event->object)) return;
     $event->return .= $this->scriptTag();
   }
 

classes/ScssArray.php

@@ -8,12 +8,16 @@
 
 class ScssArray extends FilenameArray
 {
-  public function saveSCSS(string $dst, string $style = 'compressed'): void
-  {
+  public function saveSCSS(
+    string $dst,
+    string $style = 'compressed',
+    bool $sourceMap = false,
+  ): void {
     /** @var Scss $scss */
     $scss = wire()->modules->get('Scss');
     $compiler = $scss->compiler();
     $compiler->setOutputStyle($style);
+    if ($sourceMap) $compiler->setSourceMap($compiler::SOURCE_MAP_INLINE);
 
     // Gather all unique import paths from the added files
     $importPaths = [];

docs/livereload/readme.md

@@ -14,6 +14,21 @@ Note: Enable RockDevTools only on development! RockDevTools is designed to never
 
 ## Configuration
 
+### Disabling Livereload for Specific Pages
+
+It might be the case that you want to disable LiveReload for specific pages (or the whole backend). This is how you can do it:
+
+```php
+// /site/ready.php
+wire()->addHookAfter(
+  'LiveReload::addLiveReload',
+  function (HookEvent $event) {
+    $page = $event->arguments(0);
+    if ($page->template == 'admin') $event->return = false;
+  }
+);
+```
+
 ### Watched Files
 
 RockDevTools uses Nette's File Finder to find files to watch. The default configuration at the moment of writing this documentation watches the following files:

docs/rockcss/readme.md

@@ -2,6 +2,8 @@
 
 RockCSS is a powerful CSS extension that brings fluid typography and responsive scaling to your ProcessWire projects with minimal effort. It introduces two groundbreaking functions - `grow()` and `shrink()` - that make responsive design intuitive and maintainable.
 
+> Note: As of 2025-06-11 I recommend to use RockFrontend for this feature! See the docs about the grow feature there!
+
 ## Why RockCSS is Great
 
 1. **Simplified Fluid Typography**

docs/sourcemaps/readme.md

@@ -0,0 +1,14 @@
+# SourceMaps
+
+You might want to generate sourcemaps for easier development. All you need to do is to set the `sourceMap` parameter to true:
+
+```php
+$devtools->assets()
+  ->less()
+  ->add('/site/templates/uikit/src/less/uikit.theme.less')
+  ->add('/site/templates/src/*.less')
+  ->save(
+    '/site/templates/src/.styles.css',
+    sourceMap: true,
+  );
+```