add moox/tree feature searching, filter and language switcher

Author: Reinhold-Jesse

.cursor/rules/moox-tree-integration.mdc

@@ -0,0 +1,64 @@
+---
+description: Filament-Resources an Moox Tree anbinden (Consumer außerhalb packages/tree)
+globs: "**/*TreeResource.php,**/TreeList*.php,**/TreeInspector*.php"
+alwaysApply: false
+---
+
+# Moox Tree – Resource-Integration
+
+Wenn eine Resource einen Baum-Index statt einer Tabelle nutzt.
+
+## Zentrale Nutzung (keine Duplikation)
+
+**Tree-Funktionen nicht in Consumer-Packages neu bauen** — kein eigenes Livewire für Baum-CRUD, keine kopierten Move/Reorder-Skripte, keine parallelen Action-Klassen.
+
+Consumer liefert nur:
+
+- `treeIndex(): TreeIndexConfiguration` mit `->forwardFromResource(static::class, useFilamentTableToolbar: true)` — **1:1** wie die Liste: Filament-`EmbeddedTable` (Tabs, Filter, Suche, Language-Switcher in `TOOLBAR_SEARCH_BEFORE`) + `applyFiltersToTableQuery()` / `applySearchToTableQuery()` auf der List-Page; kein separater Lang-Switcher in der Baum-Spalte
+- dünne Filament-Pages (`TreeIndexListRecords`, optional Inspector mit **Domänen-Formular**)
+- ggf. `modifyQuery` / `applySearchUsing` / `applyLanguageUsing` als **Closures** (nur Datenfilter, keine Tree-Mechanik)
+
+Braucht eine Resource ein Verhalten, das andere Bäume auch brauchen könnten → **Feature ins `packages/tree`**, dann per Config aktivieren.
+
+## Eloquent-Models
+
+**Models nicht um Tree-Funktionen erweitern** — keine Hilfsmethoden, Interfaces oder Traits nur für das Tree-Package (z. B. `getTreeLabel()`, `toTreeNode()`, `implements TreeNodeContract`).
+
+Erlaubt am Model:
+
+- Spalten/`$fillable` für `parent_id`, Sortierung, Label (oder konfigurierte Namen)
+- Bei Nested Set: Kalnoy **`NodeTrait`** (Pflicht für `nestedSet()`, sonst nichts Tree-spezifisches)
+- Domänen-Relations/Accessors, die ohnehin zur App gehören; Label-Accessor → `->labelColumnQueryable(false)` in der Resource
+
+Tree-Mechanik gehört ins **Tree-Package**; die Resource **verdrahtet** nur über `treeIndex()`. Domänen-Inhalte (Tabs, Relationen, Medien) nur im **Inspector** (Filament Edit-Page), nicht als eigene Baum-Logik.
+
+## Pflichten
+
+1. Resource: `implements Moox\Tree\Contracts\ConfiguresTreeIndex` + `treeIndex(): TreeIndexConfiguration`.
+2. List-Page: `extends Moox\Tree\Filament\Pages\TreeIndexListRecords` (registriert Config in `mount()`).
+3. Routing: `'index' => TreeListXxx::route('/')`. Bei Moox-Parent-Resources: `...Arr::except(parent::getPages(), ['index'])` beibehalten.
+4. `modifyQuery` muss dieselbe Sicht wie `Resource::getEloquentQuery()` abbilden (Policies, Soft-Deletes, Mandanten).
+
+## Inspector (empfohlen)
+
+- Eigene Edit-Page mit `RendersAsTreeIndexInspector` + Route `tree-inspector` (Policies/URLs).
+- In Config: `->inspectorPage(TreeInspectorXxx::class)`.
+- Ohne Inspector: nur eingebautes Minimalformular (Label + Parent).
+
+## Nested Set & Label
+
+- Accessor-Labels (z. B. `title` aus Translation): `->labelColumnQueryable(false)`.
+- Nested Set: `->nestedSet()->sortColumn('_lft')->reorderable(true)` und `kalnoy/nestedset` am Model.
+
+## Toolbar (Suche / Sprache)
+
+- Mit `useFilamentTableToolbar: true`: Suche, Filter und `localization::lang-selector` in der **Filament-Tabellen-Toolbar** (Render-Hook im Tree-Package); keine Tabellen-Sortierung („Sort by“), keine Zeilen-/Bulk-Actions — Reihenfolge nur im Baum (`sortColumn` / Drag).
+- Ohne Table-Toolbar: `toolbarSearch` / `toolbarLanguageSwitcher` in der Baum-Spalte; Resource liefert ggf. `applySearchUsing` / `applyLanguageUsing` — keine zweite Toolbar-Implementierung.
+
+## Trait-Shortcut
+
+`Moox\Tree\Filament\Concerns\ConfiguresTreeIndex`: `getTreeIndexListPage()` + optional `getAdditionalResourcePages()` für Inspector-Routen.
+
+## Checkliste neue Resource
+
+Model-Spalten (ohne Tree-Methoden) → `treeIndex()` → `TreeIndexListRecords` → Pages/Routes → optional Inspector → Feature-Test für Config oder Livewire.

.cursor/rules/moox-tree-package.mdc

@@ -0,0 +1,80 @@
+---
+description: Architektur und Konventionen für packages/tree (Moox Tree / filament-tree-index)
+globs: packages/tree/**
+alwaysApply: false
+---
+
+# Moox Tree Package
+
+Internes Filament-Resource-Index-UI für hierarchische Eloquent-Modelle (Baum links, Inspector rechts). Namespace: `Moox\Tree`. Views/Config-Tag: `filament-tree-index`.
+
+## Zentrale Tree-Funktionen (Single Source of Truth)
+
+**Alle Baum-Funktionen liegen in `packages/tree`** und werden von Consumer-Resources nur **konfiguriert**, nicht neu implementiert:
+
+| Bereich | Zentrale Klassen/Komponenten |
+|--------|------------------------------|
+| CRUD / Verschieben | `Actions/Tree/*` |
+| Baumstruktur | `Support/TreeStructure` |
+| UI / Interaktion | `Livewire/ResourceTreeIndex`, Blade-Views, Alpine `$store.filamentTreeIndex` |
+| Filament-Anbindung | `TreeIndexListRecords`, `ConfiguresTreeIndex`, Inspector-Trait |
+| Anpassung | `TreeIndexConfiguration` (Spalten, Modus, Hooks, Labels, Toolbar) |
+| Locale / Toolbar-i18n | `Support/TreeLocale`, `toolbarLocalizedTranslations()` |
+| List-Forwarding | `forwardFromResource()`, `Support/ResourceListForwarder` |
+
+**Flexibel nutzbar** heißt: gleicher Code für jedes hierarchische Model — Unterschiede nur über `TreeIndexConfiguration::make()` (Spaltennamen, `nestedSet()`, `reorderable`, `inspectorPage`, Closures). Fehlt eine generische Fähigkeit (z. B. Toolbar-Suche), **im Package erweitern** und per Config/API freischalten — nicht in `category`, `menu-builder` o. Ä. duplizieren.
+
+## Architektur (nicht verletzen)
+
+- **Geschäftslogik in Actions**, nicht in Livewire oder Blade: `CreateTreeNodeAction`, `UpdateTreeNodeAction`, `MoveTreeNodeAction`, `DeleteTreeNodeAction`. Bei `nestedSet()` delegieren Create/Move an `*NestedSet*`-Actions (Kalnoy `NodeTrait`).
+- **`ResourceTreeIndex`** orchestriert nur (Auth, Query, Delegation an Actions, Events). Keine neuen CRUD-Pfade direkt im Component.
+- **Baumaufbau** nur über `TreeStructure` + `TreeIndexConfiguration`. Konfiguration ist **immutable** (Fluent API mit `cloneWith`); neue Optionen brauchen Unit-Tests in `TreeIndexConfigurationTest`.
+- **Registry**: List-Pages registrieren Config unter dem **Resource-Klassennamen** (`TreeIndexConfigurationRegistry`). Schlüssel nicht umbenennen ohne Migration aller Aufrufer.
+
+## Zwei Baum-Modi
+
+| Modus | Spalten | Konfiguration |
+|-------|---------|---------------|
+| Adjacency List (Default) | `parent_id`, `sort_order`, Label-Spalte | Standard-`make()` |
+| Nested Set | `_lft`, `_rgt`, optional `parent_id` | `->nestedSet()->sortColumn('_lft')`, Model mit `NodeTrait` |
+
+Adjacency- und Nested-Set-Logik **nicht mischen** in einer Action.
+
+## UI & Frontend
+
+- Blade unter `resources/views`, Prefix `filament-tree-index::`.
+- **Filament-Komponenten** (`x-filament::*`) und `fi-*`-Klassen; Layout/Scroll in `resources/css/tree.css` (Klassen `fi-tree-*`). Kein separates Theme-CSS außerhalb des Packages für Tree-Layout.
+- Alpine-Baumzustand nur über **`$store.filamentTreeIndex`** (`scripts/alpine-tree-store.blade.php`). Keinen zweiten Store oder duplizierte Expand/Collapse-Logik in Partials.
+- Drag & Drop nur wenn `reorderable(true)`; Verschiebe-Validierung (nicht unter sich selbst / eigenes Kind) beibehalten.
+
+## Eloquent-Models (Vertrag)
+
+Das Package darf **keine eigenen Model-Methoden, Interfaces oder Contracts** voraussetzen. Nutzung nur über:
+
+- **Spalten/Attribute**: `parent_id`, Sort-Spalte, Label-Spalte (konfigurierbar), bei Nested Set `_lft`/`_rgt`
+- **Eloquent-Standard**: `getKey()`, `getAttribute()`, `update()`, `delete()`, `setAttribute()`
+- **Nested Set**: ausschließlich Kalnoy `NodeTrait` (`appendToNode`, `beforeNode`, …) — kein zusätzliches Tree-Trait im Moox-Package
+
+Neue Features im Package müssen über **Config/Actions/Resource-Hooks** lösbar sein, nicht über `if (method_exists($model, …))` oder Model-APIs.
+
+## Package-Grenzen
+
+- **Keine domänenspezifischen Daten** im Package (keine `Category`-, `Localization`- oder Mandanten-Queries). Domänenfilter nur über **konfigurierbare Closures** (`modifyQuery`, `applySearchUsing`, `applyLanguageUsing`).
+- **Generische Tree-UI und -Abläufe** (Toolbar, Reorder, Expand, Inspector-Einbettung, Validierung) gehören ins Package — auch wenn heute nur eine Resource sie nutzt.
+- Abhängigkeit `moox/core` ist erlaubt; weitere Moox-Packages nur wenn unvermeidbar und zyklusfrei.
+
+## Code-Stil
+
+- `declare(strict_types=1);` in jeder PHP-Datei.
+- PHP ^8.3, Laravel ^12, Filament ^4/5 wie im Host-Projekt, Livewire ^3/4.
+- Typisierte Closures für Query-Hooks: `fn (Builder $query): Builder`.
+
+## Tests
+
+- Tests nur unter `packages/tree/tests/` (Pest). Feature = Livewire `ResourceTreeIndex`; Unit = Config, `TreeStructure`, Registry.
+- Auth in Tests: `config(['filament-tree-index.authorization.enabled' => false])` und Registry-Register mit Test-Key.
+- Nach Verhalten ändern: `php artisan test --compact packages/tree/tests`
+
+## Referenz-Integration (außerhalb des Packages)
+
+Consumer-Resources (`implements ConfiguresTreeIndex`) gehören **nicht** in dieses Package — siehe Regel `moox-tree-integration`. Referenz: `CategoryTreeResource`, `TreeListCategories`, `TreeInspectorCategory`.

packages/category/src/Resources/CategoryResource/Pages/TreeListCategories.php

@@ -4,11 +4,15 @@
 
 namespace Moox\Category\Resources\CategoryResource\Pages;
 
+use Moox\Category\Models\Category;
 use Moox\Category\Resources\CategoryTreeResource;
+use Moox\Core\Traits\Tabs\HasListPageTabs;
 use Moox\Tree\Filament\Pages\TreeIndexListRecords;
 
 class TreeListCategories extends TreeIndexListRecords
 {
+    use HasListPageTabs;
+
     protected static string $resource = CategoryTreeResource::class;
 
     public function mount(): void
@@ -18,5 +22,22 @@ public function mount(): void
         }
 
         parent::mount();
+
+        $this->mountTabsInListPage();
+    }
+
+    public function getTabs(): array
+    {
+        return $this->getDynamicTabs('category.resources.category.tabs', Category::class);
+    }
+
+    public function updatedActiveTab(): void
+    {
+        static::getResource()::setCurrentTab($this->activeTab);
+        $this->tableFilters = null;
+        $this->tableSortColumn = null;
+        $this->tableSortDirection = null;
+        $this->resetTable();
+        $this->refreshTreeIndexConfiguration();
     }
 }

packages/category/src/Resources/CategoryTreeResource.php

@@ -4,7 +4,6 @@
 
 namespace Moox\Category\Resources;
 
-use Illuminate\Database\Eloquent\Builder;
 use Illuminate\Support\Arr;
 use Moox\Category\Models\Category;
 use Moox\Category\Resources\CategoryResource as MooxCategoryResource;
@@ -25,13 +24,13 @@ public static function getTreeIndexListPage(): string
     public static function treeIndex(): TreeIndexConfiguration
     {
         return TreeIndexConfiguration::make(Category::class)
+            ->forwardFromResource(static::class, useFilamentTableToolbar: true)
             ->labelColumn('title')
             ->labelColumnQueryable(false)
             ->nestedSet()
             ->sortColumn('_lft')
             ->reorderable(true)
             ->inspectorPage(TreeInspectorCategory::class)
-            ->modifyQuery(fn (Builder $query): Builder => static::getEloquentQuery())
             ->labels(
                 treeHeading: 'Kategorien',
                 treeSubheading: 'Baum',

packages/tree/README.md

@@ -218,13 +218,33 @@ Ohne `inspectorPage()` zeigt das Package rechts nur ein **Minimalformular** (Lab
 | `reorderable(true)`              | `true`                 | Drag & Drop (Livewire `wire:sort`)                                                                   |
 | `inspectorPage(EditPage::class)` | `null`                 | Volles Filament-Formular rechts                                                                      |
 | `modifyQuery(Closure)`           | –                      | z. B. Resource-Scopes, Soft-Deletes, Mandanten                                                       |
+| `toolbarSearch(true)`            | `false`                | Blendet ein Suchfeld im Tree-Header ein                                                              |
+| `toolbarLanguageSwitcher(true)`  | `false`                | Blendet den Language-Switcher im Tree-Header ein (falls `localization::lang-selector` vorhanden)    |
+| `applySearchUsing(Closure)`      | –                      | Eigene Suchlogik: `fn (Builder $query, string $search, TreeIndexConfiguration $config): Builder`    |
+| `applyLanguageUsing(Closure)`    | –                      | Eigene Sprachlogik: `fn (Builder $query, string $lang, TreeIndexConfiguration $config): Builder`     |
 | `authorizationAbility('update')` | `null`                 | Gate-Ability für das Model; ohne Wert nur `auth()->check()`                                          |
 | `labels(...)`                    | deutsche Standardtexte | UI-Texte (siehe unten)                                                                               |
 
 Parameter von `labels()`: `treeHeading`, `treeSubheading`, `inspectorHeading`, `createRootLabel`, `createChildLabel`, `saveLabel`, `newRecordLabel`, `deleteConfirmMessage`.
 
 `modifyQuery` sollte dieselbe Query-Logik wie `Resource::getEloquentQuery()` widerspiegeln (Policies, globale Scopes, Mandanten).
 
+### Toolbar Features (optional)
+
+Wenn du Suchfeld und/oder Language-Switcher wie in klassischen Filament-Listen brauchst, kannst du sie pro Tree-Resource aktivieren:
+
+```php
+return TreeIndexConfiguration::make(Category::class)
+    ->toolbarSearch()
+    ->toolbarLanguageSwitcher()
+    ->applyLanguageUsing(
+        fn (Builder $query, string $lang, TreeIndexConfiguration $config): Builder
+            => $query->whereHas('translations', fn (Builder $translationQuery): Builder => $translationQuery->where('locale', $lang))
+    );
+```
+
+Ohne `applyLanguageUsing()` setzt der Switcher nur den Livewire-`lang`-State und Query-String, verändert aber die Query nicht.
+
 ### Beispiel: Einfacher Baum (Adjacency List, verschiebbar)
 
 ```php

packages/tree/resources/views/filament/pages/embedded-tree-content.blade.php

@@ -0,0 +1,9 @@
+@livewire(
+    config('filament-tree-index.livewire.alias', 'filament-tree-index'),
+    [
+        'configurationKey' => $configurationKey,
+        'lang' => $this->lang,
+        'search' => $this->tableSearch ?? '',
+    ],
+    key('filament-tree-index-'.$configurationKey.'-'.md5(json_encode([$this->tableFilters ?? [], $this->tableSearch ?? '', $this->activeTab ?? '', $this->lang ?? ''])))
+)

packages/tree/resources/views/filament/pages/tree-index.blade.php

@@ -1,3 +1,4 @@
+{{-- @deprecated Tree pages use ListRecords content() + EmbeddedTable; kept for reference. --}}
 <x-filament-panels::page>
     @livewire(
         config('filament-tree-index.livewire.alias', 'filament-tree-index'),

packages/tree/resources/views/livewire/partials/tree-toolbar.blade.php

@@ -0,0 +1,23 @@
+<div
+    class="fi-sc fi-sc-has-gap fi-grid"
+    style="--cols-default: repeat(1, minmax(0, 1fr));"
+>
+    @if ($isToolbarSearchEnabled)
+        <x-filament::input.wrapper
+            prefix-icon="heroicon-m-magnifying-glass"
+            class="w-full"
+        >
+            <x-filament::input
+                type="search"
+                wire:model.live.debounce.300ms="search"
+                placeholder="Suchen..."
+            />
+        </x-filament::input.wrapper>
+    @endif
+
+    @if ($isToolbarLanguageSwitcherEnabled)
+        <div class="w-full [&_.fi-dropdown]:!block [&_.fi-dropdown]:!w-full [&_.fi-dropdown-trigger]:!w-full [&_.fi-btn]:!w-full">
+            @include('localization::lang-selector', ['fullWidth' => true])
+        </div>
+    @endif
+</div>

packages/tree/resources/views/livewire/resource-tree-index.blade.php

@@ -34,18 +34,30 @@ class="fi-sc fi-sc-has-gap fi-grid lg:fi-grid-cols"
             </x-slot>
 
             <div
-                class="fi-tabs fi-vertical fi-contained fi-tree-scroll-panel"
-                wire:key="resource-tree-{{ md5(json_encode($treeBranchIdsWithChildren)) }}"
-                x-data
-                x-init="$store.filamentTreeIndex.configure(@js($treeBranchIdsWithChildren), @js($treeAncestorIdsForSelection))"
+                class="fi-sc fi-sc-has-gap fi-grid"
+                style="--cols-default: repeat(1, minmax(0, 1fr));"
             >
-                @include('filament-tree-index::livewire.resource-tree', [
-                    'items' => $tree,
-                    'parentId' => null,
-                    'selectedRecordId' => $selectedRecordId,
-                    'configuration' => $configuration,
-                    'isRoot' => true,
-                ])
+                @if ($isToolbarSearchEnabled || $isToolbarLanguageSwitcherEnabled)
+                    @include('filament-tree-index::livewire.partials.tree-toolbar', [
+                        'isToolbarSearchEnabled' => $isToolbarSearchEnabled,
+                        'isToolbarLanguageSwitcherEnabled' => $isToolbarLanguageSwitcherEnabled,
+                    ])
+                @endif
+
+                <div
+                    class="fi-tabs fi-vertical fi-tree-scroll-panel"
+                    wire:key="resource-tree-{{ md5(json_encode($treeBranchIdsWithChildren)) }}"
+                    x-data
+                    x-init="$store.filamentTreeIndex.configure(@js($treeBranchIdsWithChildren), @js($treeAncestorIdsForSelection))"
+                >
+                    @include('filament-tree-index::livewire.resource-tree', [
+                        'items' => $tree,
+                        'parentId' => null,
+                        'selectedRecordId' => $selectedRecordId,
+                        'configuration' => $configuration,
+                        'isRoot' => true,
+                    ])
+                </div>
             </div>
 
             <x-slot name="footer">