Tables Laravel Package

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.