Tables Laravel Package

BREAKING

• A closure passed to editable() now owns persistence. Previously setColumns() nulled out every closure so Livewire could serialize the column objects, which left a closure editableCallback silently unreachable: the callback never ran, and updateField() fell through to the default write and saved the field anyway. The callback now runs, and — matching how a string callback has always behaved — it replaces the default write rather than running alongside it. A table using editable('input', [], fn ($id, $field, $value, $table) => ...) that relied on the field still being saved must now persist it from inside the closure.

Fixed

• Editable: updateField() dispatched table-field-updated before doing any work, so a denied or failed update announced itself as a successful one. It is now dispatched only once the write has actually happened — after a callback runs, after a successful model save, or after the array row is updated. A write refused by authorizeFieldUpdate()/authorizeFieldUpdateRaw(), or aimed at a record that does not exist, no longer dispatches it.
• Editable: updateField() resolves the column through getFreshColumns() instead of the serialized $this->columns, which is what makes closure callbacks reachable at all. This matches how Sort, Search and Data already resolve columns when they need callbacks intact.

BREAKING

Neither change is reachable through the package's own views: the inline editor only renders for columns marked ->editable(), and toggles only render for toggle columns. Both guards reject input the UI never produces, so the affected surface is programmatic calls and hand-crafted Livewire requests.

• updateField() now refuses to write a column that was not marked with ->editable(). Previously any declared column could be written through the inline-edit action, including display-only ones. Tables that call updateField() programmatically on a non-editable column must add ->editable() to that column's definition.
• toggleBoolean() now refuses a column key that is not part of the table's columns(). A key absent from both columns() and the row data previously raised Undefined array key and now returns quietly. The genuine behaviour change is the other case: a key present in the row data but never declared as a column — for example a data() row carrying is_admin with no matching column — used to flip successfully and is now refused.

Fixed

• Editable: authorizeFieldUpdate() was only consulted on the Eloquent write path. A column with a string editableCallback, and every array/stdClass backed table, wrote with no authorization check at all. Both paths are now gated by the new authorizeFieldUpdateRaw() hook.

Added

• authorizeFieldUpdateRaw($id, string $field, mixed $value): bool on Editable, defaulting to true. It is the counterpart of authorizeFieldUpdate() for the write paths that have no resolved Eloquent model — a column with a custom update callback, and array/stdClass backed tables — which receive the raw row id instead of a record. authorizeFieldUpdate()'s own signature is unchanged, so existing overrides typed Model $record keep working; override the new hook as well to cover the non-model paths.
• authorizeToggle($id, string $column): bool on RowManipulators, defaulting to true. Override it to gate boolean toggles the way authorizeFieldUpdate() gates field writes.

Fixed

• Cache: Object cell values (e.g. Carbon dates, backed enums, value objects) are now deep-normalized to scalars/arrays before caching, so the cache never stores objects. Previously v2.9.12 only flattened the top-level container, leaving object cell values to come back as __PHP_Incomplete_Class under Laravel 13's hardened cache unserialization — which broke rendering with htmlspecialchars(): Argument #1 ($string) must be of type string, __PHP_Incomplete_Class given. Stringable values (Carbon, etc.) are cached as their string form, preserving rendered output.
• Cache: getCachedData() now self-heals — a non-array cache hit (a legacy cached TableCollection or an incomplete-class artifact from a pre-upgrade entry) is discarded and rebuilt from source instead of rendering garbage.

Fixed

• Cache: Table data is now cached as a plain array of rows instead of the TableCollection object, and re-wrapped into a TableCollection on read. This keeps the cache compatible with Laravel 13's hardened unserialization (cache.serializable_classes) without consumers having to allow-list TableCollection. Legacy cached collections are tolerated for the remaining TTL window after upgrading.

Changed

• Dev: Upgrade Pest to v4 (pestphp/pest: ^4.0, pestphp/pest-plugin-laravel: ^4.0).

Changed

• Dependencies: Allow Livewire 4 (livewire/livewire: ^3.7|^4.0).
• Dev: Test against Laravel 13 via Orchestra Testbench 11 (orchestra/testbench: ^9.0|^10.0|^11.0).

Fixed

• GenericExport: Export headers now use column display labels (e.g., "Rol funcional") instead of raw data keys (e.g., "rol_funcional"). Works automatically for both Eloquent and array/collection tables — no changes needed in existing apps.
• GenericExport: Internal metadata keys (_original, _disabled, _hidden, _card_title) no longer leak into exported data. Previously only _original was stripped.
• exportToClipboard: Clipboard export now uses column labels as headers and filters out internal metadata keys, matching the GenericExport fix.

Added

• TableCollection: New Collection subclass that carries column label metadata from processCollection() through to GenericExport, enabling automatic label resolution without requiring changes to existing export methods.

Fixed

• Expanded Rows: Use key() helper function instead of key: named argument in [@livewire](https://github.com/livewire)() directive for inline expanded row components. The named argument syntax isn't handled by Livewire's Blade compiler regex, causing a closure parameter error when expanding task rows.

Fixed

• Column: Declare isHtml as a class property (public $isHtml = false) so property_exists() returns true on PHP 8.2+. Previously, isHtml was set dynamically in the toHtml() trait method, causing the raw-HTML branch in Blade templates to never trigger.

Added

• Column: secondaryHeader(callable $callback) method to display a secondary header row below the main header with computed content (e.g., subtotals, averages). The callback receives the current page's rows as a Collection and supports HTML output.

Added

• BeartropyTable: Customizable base query via overridable query() method — scope table data by tenant, permissions, or any custom condition without global scopes.
• BeartropyTable: Internal newQuery() wrapper that applies $with eager loading automatically on top of query().

Changed

• View: Default button variant changed from soft to glass.

Changed

• Buttons: Default button variant changed from outline to soft (light tinted background with colored text) for a consistent, subtle look across all header buttons.
• PerPage: Per-page selector now uses the shared $yat_button_variant instead of a hardcoded outline attribute, ensuring all buttons match.

Added

• Tests: Added 16 tests covering stdClass data support (unit + feature).

Fixed

• Data: stdClass rows now use ArrayObject instead of plain arrays, preserving both $row->key and $row['key'] access in user callbacks (fixes "Attempt to read property on array" regression from v2.9.2).

Changed

• Docs: Added stdClass data source documentation and examples across LLM reference, user reference, AI guide, and basic-tables examples.

Fixed

• Data: Normalize stdClass objects to arrays in processCollection() and addRowToTable(), preventing "Cannot use object of type stdClass as array" errors when data() returns stdClass objects (e.g. from json_decode() or API responses).
• Theming: Fix setTheme() not propagating to header components.

Changed

• BeartropyTable: Renamed base class from YATBaseTable to BeartropyTable. The old name continues to work via class_alias — no changes needed in existing user code.
• BeartropyTableServiceProvider: Renamed service provider from YATProvider to BeartropyTableServiceProvider. The old name extends the new one for backward compatibility.
• Stubs: make:btable now generates extends BeartropyTable instead of extends YATBaseTable.
• Docs: Comprehensive documentation overhaul — all settings methods, data access methods, view slots, theming, state persistence, spinner, cache, row manipulation, sort, bulk, and export now fully documented across LLM reference, user reference, and AI guide.
• Docs: Documentation updated to reference BeartropyTable throughout. Doc files renamed from yat-base-table to bear-table.
• Skills: bt-tables-setup updated with correct artisan command (make:btable) and BeartropyTable references.
• Skills: bt-tables-docs-maintenance updated with correct service provider path.
• MCP: ComponentDocs schema example updated from yat-base-table to bear-table.

Added

• YATBaseTable: setComponentSize() method to uniformly resize all header UI components.

Changed

• Search: Use native icon-start prop for search input magnifying glass.
• Pagination: Add cursor-pointer to pagination buttons.
• Pagination: Reset page when changing per-page option.

Fixed

• FilterSelect: Fix sending option labels instead of IDs.
• FilterSelect: Fix integer-keyed options not filtering correctly.
• ToggleColumn: Fix undefined property after Livewire serialization.

Fixed

• YATBaseTable: Removed mixed type from $model property to restore child class compatibility. Typed parent properties cannot be overridden without matching the type exactly in PHP 8.

Added

• MCP Tools: Three MCP tools (ComponentDocs, ListComponents, ProjectContext) for Laravel Boost integration.
• Skills: Setup skill (bt-tables-setup) and docs maintenance skill for AI assistants.
• Docs: LLM reference docs and user docs for all 12 components (docs/llms/, docs/components/).
• Docs: AI assistant documentation with universal guide, Cursor rules, and code examples (docs/ai-assistants/).
• Docs: Doc templates for LLM and user documentation (docs/llms/_template.md, docs/components/_template.md).
• Tests: Comprehensive test suite expanded from 39 to 243 tests covering all column types, filter types, traits, bulk actions, inline editing, filters integration, row manipulation, and export.
• Tests: MCP integrity tests ensuring documentation stays in sync with code.
• Translations: 8 missing Spanish translation keys added.

Changed

• Code Quality: Type hints added to 60 properties across all traits and classes.
• Code Quality: PHPDoc blocks added or corrected across 68 issues in all src/ files.
• Code Quality: Magic number replaced with PHP_INT_MAX constant.
• Security: Input validation and null safety improvements across multiple traits.
• Cleanup: Dead code, duplicate PHPDoc blocks, and Spanish comments removed.

Fixed

• Migration: Corrected down() method to properly reverse migration.
• Pagination: Fixed typo in pagination property name.
• Null Safety: Added null checks to prevent errors with empty data sets.

Fixed

• Fixed filters with custom queryCallback failing when no matching database column exists.
• Virtual filters (those using ->query() without a real column) now work correctly by generating a virtual key instead of requiring a column match.

Added

• Added triggerCardInfoModal(bool) method to Column class to optionally disable opening the info modal when clicking the card title on mobile.
• Support for closure callbacks in cardTitle() method to allow dynamic content generation for mobile card titles.

Changed

• Refactored Data trait and Column serialization logic to support passing closures to views, enabling more dynamic UI definitions.

Added

• Added centered() method to Column class for easy content and header alignment.

Fixed

• Fixed bulk column width issue where it expanded unnecessarily in tables with few columns.

Fixed

• Included styling fixes missed in v2.6.1 (row opacity adjustments).

Changed

• Improved table row visual hierarchy:
  • Reduced hover background opacity for clearer content visibility.
  • Subtle adjustment to even row background opacity for better contrast.

Added

• New DateColumn class for displaying formatted date values:
  • inputFormat(string) - specify expected input date format.
  • outputFormat(string) - define display format (default: Y-m-d).
  • emptyValue(string) - fallback value for null/empty dates.
• Date formatting logic in Data::transformRow() for automatic date parsing and formatting.
• Unit tests for DateColumn class.

Added

• Comprehensive test suite using PestPHP:
  • Unit Tests: Column logic (instantiation, unique keys, modifiers) and Options logic.
  • Feature Tests: Table rendering, pagination (per page, navigation), global search, and column sorting.
• Test infrastructure: TestCase setup with SQLite in-memory database and Pest configuration.
• Structural improvements in yat-table.blade.php:
  • Better handling of row expansion and mobile layout.
  • Improved empty search results display.
  • Enhanced data-attribute handling for accessibility and styling.

Changed

• Improved project documentation structure and meta-information.
• Refactored yat-table.blade.php for better readability and performance.
• Updated YATableComponent.stub with improved code styling and type hints.

Fixed

• Added docs

Fixed

• Fixed column alignment when using pushLeft() and pushRight() by adding flex utilities to header wrappers.

Changed

• Improved code styling in Column class (parameter type hints and return types).

Changed

• Changed columns to be Sortable and Searchable by default.
• Added sortable(bool) and searchable(bool) modifiers to Column class to explicitly enable/disable these features.

Fixed

• Fixed inline editing:
  • Fixed display showing ID instead of label after save.
  • Fixed initial value mismatch (display vs ID) for relationship fields.
  • Fixed empty state defaulting to first option (added placeholder).
  • Fixed Undefined array key error when updateField is not in columns.
  • Fixed data persistence issues on pagination (added wire:key and cache invalidation).
• Added setUpdateField() method to Column to support updating relationship IDs while displaying names.
• Added translations for "Select an option" placeholder.

Changed

• Enhanced Inline Editing UI:
  • Added success/error visual feedback with icons (Check/Exclamation).
  • Added loading state spinner during save.
  • Improved hover effects with specific card styling (inner div with hover:bg-amber-200 type effect).
  • Made updateField return a boolean status for UI feedback.
• Updated documentation with comprehensive examples for inline editing.

Changed

• Removed .agent folder from repository and added it to .gitignore.

Added

• Added setButtonThemeOverride(?string $theme) and setInputThemeOverride(?string $theme) to View trait to allow overriding themes for specific components.

Added

• Added useGlobalSearch(bool) method to Search trait to toggle global search input visibility.
• Added showOnlyTable(bool) method to YATBaseTable to quickly disable global search, pagination, and column toggle.
• Added pushLeft() and pushRight() methods to Column class for easy content and header alignment using Tailwind CSS.

Fixed

• Fixed table header alignment (text-left, pl-2) for the row counter column in yat-table.blade.php.

Changed

• Updated default inputThemeOverride to beartropy in View trait.

Changed

• Updated defaults in View trait to fallback to gray theme.
• Updated pagination components to respect buttonThemeOverride.

Added

• Added getThemeConfig helper method to View trait.