Merge pull request #579 from OskarLinde/feat/add-svg-helper

feature: expose page-local root SVG element as global  in rule scripts

Author: exetico

docs/_docs/03-usage.md

@@ -253,6 +253,7 @@ Service data can be dynamically constructed using JavaScript code. Below is the
 | `hass`                   | Home Assistant [hass](https://home-assistant.io/developers/development_hass_object/) object |
 | `element`                | current SVG element                                                                         |
 | `elements`               | current SVG elements                                                                        |
+| `svg`                    | Root `<svg>` element for the current floorplan page (use for scoped `querySelector(...)`)   |
 
 | Functions                | Description                                                                                 |
 | ------------------------ | ------------------------------------------------------------------------------------------- |

src/components/floorplan/floorplan-element.ts

@@ -1715,6 +1715,7 @@ export class FloorplanElement extends LitElement {
           this.svgElements,
           this.functions,
           svgElementInfo,
+          this.svg,
           ruleInfo
         );
       } catch (err) {

src/components/floorplan/lib/eval-helper.ts

@@ -45,6 +45,7 @@ export class EvalHelper {
     svgElements?: { [elementId: string]: SVGGraphicsElement },
     functions?: unknown,
     svgElementInfo?: FloorplanSvgElementInfo,
+    svg?: SVGGraphicsElement,
     ruleInfo?: FloorplanRuleInfo
   ): unknown {
     this.expression = expression.trim();
@@ -97,6 +98,7 @@ export class EvalHelper {
     this.interpreter.import('hass', hass);
     this.interpreter.import('element', svgElement);
     this.interpreter.import('elements', svgElements);
+    this.interpreter.import('svg', svg); // Provide direct access to the root <svg> element for rule scripts
 
     // Let the user call "action" function (to call our service call-handler)
     this.interpreter.import('action',