✨ New Features

• Custom Export with Column Selection:

  • Interactive modal to choose which columns to export
  • Select All / Deselect All controls for quick selection
  • Columns grouped by their source table (main table + relations)
  • Smart column detection — excludes internal fields (id, password, remember_token, timestamps, soft deletes)
  • Per-export paper size (A4, Letter, Legal) and orientation (Portrait, Landscape)
  • Export to Excel or PDF with custom column selection
  • Dark mode support for the entire modal UI
  • Works across all template systems (Tailwind, Bootstrap)
  • Configurable theme classes for all modal elements

• Per-Export Paper Size & Orientation:

  • PDF exports now accept $paperSize and $orientation parameters
  • Falls back to config defaults when not specified
  • Dynamic PDF font sizing (140 / columnCount) and cell padding (80 / columnCount)
  • word-break: break-word prevents content overflow in PDF cells

• Enhanced Export API:

  • export(string $type, ?array $selectedColumns, ?string $paperSize, ?string $orientation) — supports passing selected columns, paper size, and orientation
  • customExport() action for Livewire modal integration
  • #[Computed] exportColumns property — lists all exportable columns with labels
  • showCustomExportPanel() / closeCustomExport() actions for modal management
  • toggleCustomExportColumn(), selectAllExportColumns(), deselectAllExportColumns() for column selection

🔧 Improvements

• Default export (Excel/PDF buttons) remains fully backward compatible
• Existing export respects filters and search as before
• DOMPDF options: isHtml5ParserEnabled, isFontSubsettingEnabled, defaultFont => serif, dpi => 96 for better PDF rendering
• [@page](https://github.com/page) { margin: 10mm; } for consistent PDF margins

🎨 UI/UX

• Custom Export option added to export dropdown with visual separator
• Modal with checkboxes organized by table groups
• Livewire live model binding for instant UI updates
• Disabled submit button when no columns selected
• Smooth dark mode adaptation for all modal elements

Highlights

• Livewire v4 Upgrade: The package has been upgraded to support Livewire v4, ensuring compatibility with the latest version of the framework.
• Bootstrap 5+ Template Support: A new default template for Bootstrap 5+ has been added, allowing users to choose between Tailwind CSS and Bootstrap for styling their DataTables. This includes extensive dynamic class configuration for Bootstrap elements.
• Advanced Filter Bug Fix: A bug related to the advanced search filter when used with query scopes has been resolved, improving the reliability of filtering functionality.
• Enhanced Type Hinting and Readability: Numerous methods across the codebase have been updated with explicit type hints for parameters and return types, improving code clarity, maintainability, and static analysis.

v1.4.0 - 2025-12-11

✨ New Features

• Advanced Dynamic Filter System:

  • Multiple column filtering with configurable UI
  • Filter by multiple conditions on same table
  • Real-time filter application with visual feedback
  • Filter state management (add, delete, reset)
  • Works seamlessly with sorting and pagination
  • Support for text input and dropdown filters
  • Enable/disable filters via configuration
  • Advanced filter panel with collapsible interface

• Default Sort Configuration:

  • Custom default sort field per table
  • Custom default sort direction (asc/desc)
  • Maintains default sort on page load
  • Flexible sort reset with filtering
  • Supports sorting by relationships

• Fully Dynamic CSS Classes:

  • All CSS classes moved to configuration file
  • Dynamic class binding for all UI elements
  • Data attributes for debugging and inspection
  • Complete theme customization without template changes
  • Icon styling configuration (SVG classes)
  • Layout wrapper configuration
  • Text styling configuration

• Enhanced Export with Filtering:

  • Export respects active filters and search
  • Export with applied sorting
  • Filtered exports with proper naming convention
  • Support for searched data export

🔧 Improvements

• Improved sorting behavior when filtering is active
• Better pagination handling with active filters
• Reset sort field when filtering data
• Dynamic class extraction via getClass() method
• All SVG icon classes configurable
• All layout wrapper classes configurable
• Per-page text styling configurable
• Column header text styling configurable

🏗 Architecture

• Implemented filterData() method for filtering logic
• Enhanced getQuery() computed property for filtered queries
• Improved sort reset mechanism
• Dynamic theme loading from configuration
• Trait-based approach maintained for extensibility

🎨 UI/UX

• Professional filter panel with icons
• Smooth animations and transitions
• Responsive filter controls
• Dark mode support for all new elements
• Better visual hierarchy in filter UI
• Collapsible filter sections
• Visual feedback for active filters

🔐 Security

• Filter validation with model scope
• Safe query parameter handling
• Protection against unauthorized filtering

📚 Documentation

• Added advanced filtering documentation
• Filter configuration examples
• Default sort configuration guide
• Theme customization guide
• Dynamic class configuration reference
• CSS class reference with data-class attributes

[v1.3.0] - 2025-10-18

✨ New Features

• Added comprehensive export functionality:

  • Export to Excel and PDF formats
  • Support for exporting all data regardless of pagination
  • Configurable export buttons with dropdown interface
  • Custom filename generation with search context
  • Proper formatting in exported files
  • Exclude action columns from exports
  • Support for all data types and relationships

• Enhanced pagination system:

  • Added "Show All" records option
  • Dynamic handling of large datasets
  • Improved performance with optimized queries
  • Maintains search and sort functionality
  • Smooth transition between page sizes

🔧 Improvements

• Optimized data export for large datasets
• Better handling of formatters in exports
• Improved memory efficiency for large exports
• Enhanced search functionality with export integration
• Added export button position configuration
• support custom params for scopr

🏗 Architecture

• Introduced WithExport trait for export functionality
• Added DataTableExport class for Excel exports
• Improved PDF template system
• Better handling of data transformations

📚 Documentation

• Added export configuration documentation
• Updated pagination examples
• Added formatter integration examples
• New examples for customizing exports

[v1.2.0] - 2025-09-19

✨ New Features

• Enhanced API integration:

  • Flexible response mapping
  • Customizable query parameters
  • Robust error handling
  • Support for nested API responses

• Added advanced value formatting system:

  • Simple formatters (date, datetime, currency, boolean, etc.)
  • Complex formatters with customizable options
  • Custom date format patterns support
  • Flexible number and currency formatting
  • Text manipulation (limit, words, markdown)
  • Support for both Model and API data sources

• Improved pagination system:

  • Support for both default and simple pagination
  • Total count display in simple pagination mode
  • Consistent behavior across data sources
  • Query parameter preservation in pagination links

🔧 Improvements

• Refactored formatting logic into WithFormatters trait
• Added support for custom formatter options
• Improved type declarations and PHP 8.2 compatibility
• Better error handling for API responses

🏗 Architecture

• Introduced WithFormatters trait for better code organization
• Improved separation of concerns in data handling
• Enhanced type safety across components
• Better abstraction for data sources

📚 Documentation

• Added comprehensive formatter documentation
• Improved API integration examples
• Added date format pattern examples
• Updated configuration examples

Release v1.1.0

✨ New Features

• ⚡ Server-side rendering - Handle large datasets efficiently
• 🚀 Performance improvements - Up to 40% faster with Livewire Computed Properties
• 📄 Dynamic pagination - Added simplePaginate method option
• 🔢 Enhanced number column - no column now sortable with proper numbering
• 🔍 Query scope support - Apply custom model scopes for filtered datasets

🔧 Configuration

Pagination Options

// Global config
'default_pagination' => 'simplePaginate', // or 'paginate'

// Per component
'pagination' => 'simplePaginate'

Number Column Usage

'columns' => [
    'no' => '#',        // Auto-numbered, sortable
    'name' => 'Name',
    'email' => 'Email'
]

Query Scope Usage

// In your model
public function scopeActive($query) {
    return $query->where('status', 'active');
}

// In component
'model' => User::class,
'scope' => 'active'  // Apply the scope

# Update existing
composer update developerawam/livewire-datatable

# clear cache
php artisan optimize:clear

🔄 Breaking Changes

None - fully backward compatible

📝 Release Notes

🚀 Highlights

• Initial stable release of Laravel Livewire DataTable
• Built for Laravel 12.x, Livewire 3.x, and TailwindCSS 3.x
• Out of the box: search, sorting, pagination, theming, and dark mode

✨ Features

• 🔍 Live Search with debouncing
• 🔄 Column Sorting, including relationship fields
• 📄 Dynamic Pagination
• 🎨 Customizable Themes with TailwindCSS
• 🌓 Dark Mode Support (automatic with Tailwind dark mode)
• 📱 Responsive Design
• 🔗 Relationship Column Support
• ⚡ Real-time Updates via Livewire
• 🎯 Custom Cell Templates for action buttons or custom UI
• 🛠 Event-driven Architecture for interactive tables

🔒 Security

• Please report security issues via info@developerawam.com
• (not GitHub issues)