Support for property groups in variant elements, in TDFs

build/scripts/Targets/TargetDescriptionFiles/Services/AtdfService.php

@@ -1046,7 +1046,8 @@ class AtdfService
                 strtolower($attributes['ordercode'] ?? $attributes['name'] ?? '')
             ),
             $attributes['ordercode'] ?? $attributes['name'] ?? null,
-            isset($attributes['pinout']) ? strtolower($attributes['pinout']) : null
+            isset($attributes['pinout']) ? strtolower($attributes['pinout']) : null,
+            []
         );
     }
 }

build/scripts/Targets/TargetDescriptionFiles/Services/ValidationService.php

@@ -1039,6 +1039,17 @@ class ValidationService
                 . '" - check pinout key';
         }
 
+        $processedPropertyGroupKeys = [];
+        foreach ($variant->propertyGroups as $propertyGroup) {
+            $failures = array_merge($failures, $this->validatePropertyGroup($propertyGroup));
+
+            if ($propertyGroup->key !== null && in_array($propertyGroup->key, $processedPropertyGroupKeys)) {
+                $failures[] = 'Duplicate property group key ("' . $propertyGroup->key . '") detected';
+            }
+
+            $processedPropertyGroupKeys[] = $propertyGroup->key;
+        }
+
         return array_map(
             fn (string $failure): string => 'Variant "' . $variant->name . '" validation failure: ' . $failure,
             $failures

build/scripts/Targets/TargetDescriptionFiles/Services/Xml/FromXmlService.php

@@ -450,10 +450,32 @@ class FromXmlService
     {
         $attributes = $this->getNodeAttributesByName($element);
 
-        return new Variant(
+        $output = new Variant(
             $attributes['key'] ?? null,
             $attributes['name'] ?? null,
-            $attributes['pinout-key'] ?? null
+            $attributes['pinout-key'] ?? null,
+            []
         );
+
+        $propertyGroupsElements = $element->getElementsByTagName('property-groups');
+        if (
+            $propertyGroupsElements->count() === 1
+            && ($propertyGroupsElement = $propertyGroupsElements->item(0)) instanceof DOMElement
+        ) {
+            foreach ($propertyGroupsElement->childNodes as $childNode) {
+                if (!$childNode instanceof DOMElement) {
+                    continue;
+                }
+
+                if ($childNode->nodeName === 'property-group') {
+                    $output->propertyGroups[] = $this->propertyGroupFromElement($childNode);
+                }
+            }
+
+        } elseif ($propertyGroupsElements->count() > 1) {
+            throw new XmlParsingException('Unexpected number of "property-groups" elements');
+        }
+
+        return $output;
     }
 }

build/scripts/Targets/TargetDescriptionFiles/Services/Xml/ToXmlService.php

@@ -406,6 +406,15 @@ class ToXmlService
         $element->setAttribute('name', $variant->name);
         $element->setAttribute('pinout-key', $variant->pinoutKey);
 
+        if (!empty($variant->propertyGroups)) {
+            $propertyGroupsElement = $document->createElement('signals');
+            foreach ($variant->propertyGroups as $propertyGroup) {
+                $propertyGroupsElement->append($this->propertyGroupToXml($propertyGroup, $document));
+            }
+
+            $element->append($propertyGroupsElement);
+        }
+
         return $element;
     }
 }

build/scripts/Targets/TargetDescriptionFiles/Variant.php

@@ -1,16 +1,52 @@
 <?php
 namespace Targets\TargetDescriptionFiles;
 
+require_once __DIR__ . "/PropertyGroup.php";
+
 class Variant
 {
     public ?string $key = null;
     public ?string $name = null;
     public ?string $pinoutKey = null;
 
-    public function __construct(?string $key, ?string $name, ?string $pinoutKey)
+    /** @var PropertyGroup[] */
+    public array $propertyGroups = [];
+
+    public function __construct(?string $key, ?string $name, ?string $pinoutKey, array $propertyGroups)
     {
         $this->key = $key;
         $this->name = $name;
         $this->pinoutKey = $pinoutKey;
+        $this->propertyGroups = $propertyGroups;
+    }
+
+    public function getPropertyGroup(array|string $keys): ?PropertyGroup
+    {
+        if (is_string($keys)) {
+            $keys = explode('.', $keys);
+        }
+
+        $firstLevelGroupKey = array_shift($keys);
+        foreach ($this->propertyGroups as $propertyGroup) {
+            if ($propertyGroup->key === $firstLevelGroupKey) {
+                return !empty($keys) ? $propertyGroup->getSubgroup($keys) : $propertyGroup;
+            }
+        }
+
+        return null;
+    }
+
+    public function getProperty(array|string $propertyGroupKeys, $propertyKey): ?Property
+    {
+        return ($propertyGroup = $this->getPropertyGroup($propertyGroupKeys)) instanceof PropertyGroup
+            ? $propertyGroup->getProperty($propertyKey)
+            : null;
+    }
+
+    public function getPropertyValue(array|string $propertyGroupKeys, $propertyKey): ?string
+    {
+        return ($property = $this->getProperty($propertyGroupKeys, $propertyKey)) instanceof Property
+            ? $property->value
+            : null;
     }
 }