Merge pull request #167 from gp-lnuff/4.x

[4.x] Add Append Feature

Author: CodeWithDennis

README.md

@@ -223,6 +223,25 @@ use CodeWithDennis\FilamentSelectTree\SelectTree;
 ])
 ```
 
+If you need to append an item to the tree menu, use the `append` method. This method also accepts an array or a closure.
+
+```php
+->schema([
+    SelectTree::make('category')
+        ->relationship('categories', 'name', 'parent_id')
+        ->enableBranchNode()
+        ->multiple(false)
+        ->append([
+            'name' => 'Uncategorized Records',
+            'value' => -1,
+            'parent' => null, // optional
+            'disabled' => false, // optional
+            'hidden' => false, // optional
+            'children' => [], // optional
+        ])
+    ])
+```
+
 ## Filters
 
 Use the tree in your table filters. Here's an example to show you how.

src/SelectTree.php

@@ -88,6 +88,8 @@ class SelectTree extends Field implements HasAffixActions
 
     protected Closure|array|null $prepend = null;
 
+    protected Closure|array|null $append = null;
+
     protected Closure|string|null $treeKey = 'treeKey';
 
     protected function setUp(): void
@@ -316,6 +318,18 @@ public function prepend(Closure|array|null $prepend = null): static
         return $this;
     }
 
+    public function append(Closure|array|null $append = null): static {
+        $this->append = $this->evaluate($append);
+
+        if (is_array($this->append) && isset($this->append['name'], $this->append['value'])) {
+            $this->append['value'] = (string) $this->append['value'];
+        } else {
+            throw new \InvalidArgumentException('The provided append value must be an array with "name" and "value" keys.');
+        }
+
+        return $this;
+    }
+
     public function getRelationship(): BelongsToMany|BelongsTo
     {
         return $this->getModelInstance()->{$this->evaluate($this->relationship)}();
@@ -422,8 +436,10 @@ public function storeResults(bool $storeResults = true): static
 
     public function getTree(): Collection|array
     {
-        return $this->evaluate($this->buildTree()->when($this->prepend,
-            fn (Collection $tree) => $tree->prepend($this->evaluate($this->prepend))));
+        return $this->evaluate($this->buildTree()
+            ->when($this->prepend, fn(Collection $tree) => $tree->prepend($this->evaluate($this->prepend)))
+            ->when($this->append, fn(Collection $tree) => $tree->push($this->evaluate($this->append)))
+        );
     }
 
     public function getResults(): Collection|array|null