Dendros for Filament

Dendros supplies Eloquent and Filament building blocks for hierarchical records. It combines database path helpers, ancestor and descendant relations, a tree-aware model concern, tree selection and tree table pages.

Features

• AsTree concern for hierarchical Eloquent models.
• Materialized path value object and database helpers.
• Ancestors, Descendants and deep has-many relations.
• Filament NodeTree form component.
• TreeTable, RecordsTree and RelationsTree UI foundations.
• Integration with Filament Select Tree and Filament Tree Table.

Installation

composer require phpinnacle/dendros
php artisan vendor:publish --tag="phpinnacle-dendros-migrations"
php artisan migrate

The published migration creates the database helpers required by the path implementation. Review it for compatibility with the application's database engine before running it.

Model usage

use Illuminate\Database\Eloquent\Model;
use PHPinnacle\Dendros\AsTree;

class Category extends Model
{
    use AsTree;
}

Use NodeTree when a Filament form must select a node, and extend RecordsTree or RelationsTree for dedicated hierarchy pages. TreeTable provides the corresponding hierarchical table configuration.

The model and migration must follow the column contract expected by AsTree; inspect the concern and sibling models before adapting an existing table.

Ancestor and descendant relations exclude the current node and return the same members through lazy loading, eager loading, and whereHas(). Path comparisons respect whole ltree labels: root.a is not an ancestor of root.ab. The direct Database\Path::isAncestorOf() helper includes equality, while model comparisons exclude self.

Testing

composer test

Run the PostgreSQL relation tests against a dedicated database with permission to create the ltree extension:

DENDROS_PGSQL_URL=postgresql://user:password@localhost/test_database vendor/bin/pest packages/dendros/tests --no-coverage

The integration tests use temporary tables inside rolled-back transactions and are skipped when the URL is absent.

Changelog and license

See CHANGELOG. Released under the MIT License.