Upgrade from 0.x to 1.0.0

Version 1.0.0 is the first stable release and intentionally includes breaking changes from the experimental 0.x series.

Service Provider

If your application manually registers the provider, replace the old provider class:

Trinetus\LivewireDatatables\LaravelServiceProvider::class,

With the new provider class:

Trinetus\LivewireDatatables\LivewireDatatablesServiceProvider::class,

Applications using Laravel package discovery do not need manual provider registration.

Publishing

Replace any custom publish command usage with Laravel's standard vendor:publish tags:

php artisan vendor:publish --tag=livewire-datatables-config
php artisan vendor:publish --tag=livewire-datatables-views
php artisan vendor:publish --tag=livewire-datatables-translations
php artisan vendor:publish --tag=livewire-datatables-assets
php artisan vendor:publish --tag=livewire-datatables-migrations

Filters

Review custom filters. Any custom filter type must implement the strengthened FilterTypeInterface methods:

public function getName(): string;
public function getLabel(): string;
public function getCallbackFunction(): string;
public function htmlOutput(): string;

Guest Settings

Guests no longer create rows in datagrid_config. Persisted datagrid settings are stored only for authenticated users.

Migration

If you published the old migration, remove the hard users.id foreign key manually or publish the 1.0 migration before running it in new applications.

HTML Escaping

If you want safer generated HTML output, set livewire-datatables.settings.escape-html to true.

The default remains false to preserve existing rendering behavior.

SCSS Path

Update SCSS imports from datatables.scss to datagrid.scss:

@import "../../vendor/trinetus/livewire-datatables/resources/scss/datagrid.scss";