Enable manually controlling tree node collapsed state.

Author: skoro

README.md

@@ -317,6 +317,15 @@ public function getTreeRecordIcon(?\Illuminate\Database\Eloquent\Model $record =
 ```
 ![tree-icon](https://github.com/solutionforest/filament-tree/assets/68525320/6a1ef719-9029-4e91-a20a-515a514c4326)
 
+#### Node collapsed state
+You can customize a collapsed state of the node. If you would like to show your tree initially collapsed you can use:
+
+```php
+public function getNodeCollapsedState(?\Illuminate\Database\Eloquent\Model $record = null): bool
+{
+    return false;
+}
+```
 
 ### Pages
 This plugin enables you to create tree pages in the admin panel. To create a tree page for a model, use the `make:filament-tree-page` command. For example, to create a tree page for the ProductCategory model, you can run:

resources/views/components/tree/item.blade.php

@@ -14,6 +14,7 @@
     $parentKey = $tree->getParentKey($record);
 
     $children = $record->children;
+    $collapsed = $this->getNodeCollapsedState($record);
 
     $actions = $tree->getActions();
 @endphp
@@ -48,10 +49,10 @@
                 'dd-item-btns',
                 'hidden' => ! count($children),
             ])>
-                <button data-action="expand" class="hidden">
+                <button data-action="expand" @class(['hidden' => ! $collapsed])>
                     <x-heroicon-o-chevron-down class="text-gray-400 w-4 h-4"/>
                 </button>
-                <button data-action="collapse">
+                <button data-action="collapse" @class(['hidden' => $collapsed])>
                     <x-heroicon-o-chevron-up class="text-gray-400 w-4 h-4"/>
                 </button>
             </div>
@@ -64,7 +65,7 @@
         @endif
     </div>
     @if (count($children))
-        <x-filament-tree::tree.list :records="$children" :containerKey="$containerKey" :tree="$tree" />
+        <x-filament-tree::tree.list :records="$children" :containerKey="$containerKey" :tree="$tree" :collapsed="$collapsed"/>
     @endif
     <div class="rounded-lg border border-gray-300 mb-2 w-full px-4 py-4 animate-pulse hidden" 
         wire:loading.class.remove.delay="hidden" 

resources/views/components/tree/list.blade.php

@@ -1,5 +1,14 @@
-@props(['records', 'containerKey', 'tree'])
-<ol class="filament-tree-list dd-list">
+@props([
+    'records',
+    'containerKey',
+    'tree',
+    'collapsed' => null,
+])
+<ol @class([
+    'filament-tree-list',
+    'dd-list',
+    'hidden' => $collapsed,
+])>
     @foreach ($records ?? [] as $record)
         @php
             $title = $this->getTreeRecordTitle($record);

src/Concern/InteractWithTree.php

@@ -81,6 +81,11 @@ public function getParentKey(?Model $record):?string
         return $this->getCachedTree()->getParentKey($record);
     }
 
+    public function getNodeCollapsedState(?Model $record = null): bool
+    {
+        return false;
+    }
+
     /**
      * Update the tree list.
      */