feat: add possibility to edit the dialog box configuration of an areabrick

- Introduced `DialogBoxConfigurator` interface for custom dialog box configurations.
- Enabled setting min/max constraints on `NumericItem` with validation.
- Allowed dynamic store updates in `SelectItem` via `setStore`.
- Enhanced `PanelItem` and `TabPanelItem` to manage editable items and tabs, including removal and access.
- Added `HasDialogBox` functionality for integrating and configuring dialog boxes via container-registered configurators.
- Expanded `DialogBoxBuilder` with richer tab and content management capabilities.

Author: jdreesen

src/DialogBoxBuilder.php

@@ -70,6 +70,20 @@ public function addContent(EditableItem ...$items): static
         return $this;
     }
 
+    public function hasContent(): bool
+    {
+        return isset($this->content);
+    }
+
+    public function getContent(): PanelItem
+    {
+        if (!isset($this->content)) {
+            throw new \LogicException('You cannot get content without adding content first.');
+        }
+
+        return $this->content;
+    }
+
     /**
      * @return $this
      */
@@ -85,6 +99,20 @@ public function addTab(string $title, EditableItem ...$items): static
         return $this;
     }
 
+    public function hasTab(string $title): bool
+    {
+        return isset($this->tabs) && $this->tabs->hasTab($title);
+    }
+
+    public function getTab(string $title): PanelItem
+    {
+        if (!isset($this->tabs)) {
+            throw new \LogicException('You cannot get a tab without adding tabs first.');
+        }
+
+        return $this->tabs->getTab($title);
+    }
+
     public function createCheckbox(string $name): CheckboxItem
     {
         return new CheckboxItem($name);

src/DialogBoxConfigurator.php

@@ -0,0 +1,61 @@
+<?php
+declare(strict_types=1);
+
+namespace Neusta\Pimcore\AreabrickConfigBundle;
+
+use Pimcore\Model\Document\Editable;
+use Pimcore\Model\Document\Editable\Area\Info;
+
+/**
+ * Allows configuring a {@see DialogBoxBuilder} instance.
+ *
+ * This is useful if you want to customize the default configuration,
+ * for example, if the areabrick is used within the area of another areabrick.
+ * In this case, you may, for example, want to change the default values of an item
+ * or the possible values of a select item.
+ *
+ * ```
+ * namespace App\Areabrick;
+ *
+ * use Neusta\Pimcore\AreabrickConfigBundle\DialogBoxBuilder;
+ * use Neusta\Pimcore\AreabrickConfigBundle\DialogBoxConfigurator;
+ * use Pimcore\Model\Document\Editable;
+ * use Pimcore\Model\Document\Editable\Area\Info;
+ *
+ * final class MyAreabrickDialogBoxConfigurator implements DialogBoxConfigurator
+ * {
+ *     public function configureDialogBox(DialogBoxBuilder $dialogBox, Editable $area, ?Info $info): void
+ *     {
+ *         $dialogBox->height(500);
+ *
+ *         $dialogBox->getTab('General')
+ *             ->getEditableItem('my-select')
+ *                 ->setStore([
+ *                     'option1' => 'Option 1',
+ *                     'option2' => 'Option 2',
+ *                 ])
+ *                 ->setDefaultValue('option2');
+ *
+ *          $dialogBox->reloadOnClose(false);
+ *     }
+ * }
+ * ```
+ *
+ * After registering the configurator with its FQCN in the container,
+ * the configurator can be used like this:
+ *
+ * ```
+ * {{ pimcore_area('myfield', {
+ *     type: 'my-areabrick',
+ *     params: {
+ *         'my-areabrick': {
+ *             dialogBoxConfigurator: 'App\Areabrick\MyAreabrickDialogBoxConfigurator',
+ *         }
+ *     },
+ * }) }}
+ * ```
+ */
+interface DialogBoxConfigurator
+{
+    public function configureDialogBox(DialogBoxBuilder $dialogBox, Editable $area, ?Info $info): void;
+}

src/EditableDialogBox/EditableItem/NumericItem.php

@@ -9,13 +9,42 @@ class NumericItem extends EditableItem
 {
     private int $min;
     private int $max;
+    private int $default;
 
     public function __construct(string $name, int $min, int $max)
     {
         parent::__construct('numeric', $name);
         $this->min = $min;
         $this->max = $max;
-        $this->setDefaultValue($this->min);
+        $this->default = $min;
+    }
+
+    /**
+     * @return $this
+     */
+    public function setMin(int $min): static
+    {
+        $this->min = $min;
+
+        if ($this->default < $min) {
+            $this->default = $min;
+        }
+
+        return $this;
+    }
+
+    /**
+     * @return $this
+     */
+    public function setMax(int $max): static
+    {
+        $this->max = $max;
+
+        if ($this->default > $max) {
+            $this->default = $max;
+        }
+
+        return $this;
     }
 
     /**
@@ -27,14 +56,17 @@ public function setDefaultValue(int $value): static
             throw new \InvalidArgumentException(\sprintf('Default value "%d" is out of bounds: [%d,%d]', $value, $this->min, $this->max));
         }
 
-        return $this->addConfig('defaultValue', (string) $value);
+        $this->default = $value;
+
+        return $this;
     }
 
     protected function getConfig(): array
     {
         return [
             'minValue' => $this->min,
             'maxValue' => $this->max,
+            'defaultValue' => (string) $this->default,
         ];
     }
 }

src/EditableDialogBox/EditableItem/SelectItem.php

@@ -16,8 +16,19 @@ class SelectItem extends EditableItem
     public function __construct(string $name, array $store)
     {
         parent::__construct('select', $name);
+        $this->setStore($store);
+    }
+
+    /**
+     * @param non-empty-array<array-key, string> $store
+     *
+     * @return $this
+     */
+    public function setStore(array $store): static
+    {
         $this->store = self::pack($store);
-        $this->setDefaultValue(array_key_first($store));
+
+        return $this->setDefaultValue(array_key_first($store));
     }
 
     /**

src/EditableDialogBox/LayoutItem.php

@@ -46,6 +46,16 @@ protected function addItem(DialogBoxItem $item): static
         return $this;
     }
 
+    /**
+     * @return $this
+     */
+    protected function removeItem(DialogBoxItem $item): static
+    {
+        unset($this->items[spl_object_id($item)]);
+
+        return $this;
+    }
+
     protected function getAttributes(): array
     {
         $items = [];

src/EditableDialogBox/LayoutItem/PanelItem.php

@@ -4,6 +4,7 @@
 namespace Neusta\Pimcore\AreabrickConfigBundle\EditableDialogBox\LayoutItem;
 
 use Neusta\Pimcore\AreabrickConfigBundle\EditableDialogBox\DialogBoxItem;
+use Neusta\Pimcore\AreabrickConfigBundle\EditableDialogBox\EditableItem;
 use Neusta\Pimcore\AreabrickConfigBundle\EditableDialogBox\LayoutItem;
 
 /**
@@ -13,24 +14,49 @@ class PanelItem extends LayoutItem
 {
     public readonly string $title;
 
+    /** @var array<string, EditableItem> */
+    private array $editableItems;
+
     /**
      * @param list<DialogBoxItem> $items
      */
     public function __construct(string $title, array $items = [])
     {
-        parent::__construct('panel', $items);
+        parent::__construct('panel', []);
         $this->title = $title;
+        $this->addItem(...$items);
     }
 
     public function addItem(DialogBoxItem ...$items): static
     {
         foreach ($items as $item) {
             parent::addItem($item);
+
+            if ($item instanceof EditableItem) {
+                $this->editableItems[$item->name()] = $item;
+            }
         }
 
         return $this;
     }
 
+    public function getEditableItem(string $name): EditableItem
+    {
+        return $this->editableItems[$name]
+            ?? throw new \InvalidArgumentException(\sprintf('Editable item with name "%s" not found.', $name));
+    }
+
+    public function removeEditableItem(string $name): static
+    {
+        if (!$item = $this->editableItems[$name] ?? null) {
+            throw new \InvalidArgumentException(\sprintf('Editable item with name "%s" not found.', $name));
+        }
+
+        unset($this->editableItems[$name]);
+
+        return $this->removeItem($item);
+    }
+
     protected function getAttributes(): array
     {
         return ['title' => $this->title] + parent::getAttributes();

src/EditableDialogBox/LayoutItem/TabPanelItem.php

@@ -30,4 +30,26 @@ public function getOrCreateTab(string $title): PanelItem
 
         return $this->items[$title];
     }
+
+    public function hasTab(string $title): bool
+    {
+        return isset($this->items[$title]);
+    }
+
+    public function getTab(string $title): PanelItem
+    {
+        return $this->items[$title]
+            ?? throw new \InvalidArgumentException(\sprintf('Tab with title "%s" not found.', $title));
+    }
+
+    public function removeTab(string $title): static
+    {
+        if (!$item = $this->items[$title] ?? null) {
+            throw new \InvalidArgumentException(\sprintf('Tab with title "%s" not found.', $title));
+        }
+
+        unset($this->items[$title]);
+
+        return $this->removeItem($item);
+    }
 }

src/HasDialogBox.php

@@ -2,12 +2,15 @@
 
 namespace Neusta\Pimcore\AreabrickConfigBundle;
 
+use Pimcore\Extension\Document\Areabrick\AbstractAreabrick;
 use Pimcore\Extension\Document\Areabrick\EditableDialogBoxConfiguration;
 use Pimcore\Model\Document\Editable;
 use Pimcore\Model\Document\Editable\Area\Info;
 
 /**
  * @template T of DialogBoxBuilder
+ *
+ * @mixin AbstractAreabrick
  */
 trait HasDialogBox
 {
@@ -17,6 +20,12 @@ final public function getEditableDialogBoxConfiguration(Editable $area, ?Info $i
 
         $this->buildDialogBox($builder, $area, $info);
 
+        if ($configurator = $info?->getParam('dialogBoxConfigurator')) {
+            if ($this->container->has($configurator)) {
+                $this->container->get($configurator)->configureDialogBox($builder, $area, $info);
+            }
+        }
+
         return $builder->build();
     }