Livewire Ui Components Laravel Package

Added

• Cross-cutting UI extension hooks powered by artisanpack-ui/hooks. Nine seams for applications and third-party packages to extend rendered classes, attributes, icons, toasts, table columns, theme configuration, modal lifecycle, and spotlight commands without editing individual components. See the "Extension Hooks" section of the README for the full table. (#108)
  • ap.livewireUiComponents.componentClasses filter — opt-in per component via $this->getClasses($classes)
  • ap.livewireUiComponents.componentAttributes filter — fires on every component render
  • ap.livewireUiComponents.iconAlias filter
  • ap.livewireUiComponents.toastDispatched action
  • ap.livewireUiComponents.tableColumns filter
  • ap.livewireUiComponents.themeColors filter
  • ap.livewireUiComponents.modalWillOpen / modalWillClose actions (via Support\ModalBridge)
  • ap.livewireUiComponents.spotlightCommands filter
• New ArtisanPack\LivewireUiComponents\View\Components\BaseComponent abstract class that all Blade components now extend. Provides the shared render-pipeline seams for classes and attributes.
• New ArtisanPack\LivewireUiComponents\Support\ModalBridge helper for firing modal lifecycle hooks server-side.

Changed

• Require artisanpack-ui/hooks: ^1.2.

CI

• Drop Laravel 10 from the CI test matrix. The ecosystem dependencies (artisanpack-ui/hooks, icons, accessibility, core) all now require illuminate/support: ^11+, so composer cannot resolve a Laravel 10 test run regardless of this package's own constraint.
• Run Feature tests unconditionally (if: always()) so new Feature-suite coverage exercises even when pre-existing Unit-suite failures make the earlier step exit non-zero.

Changed

• Widened owenvoke/blade-fontawesome constraint from ^2.9 to ^2.9|^3.0 to unblock Laravel 13 adoption in downstream consumers (the v2.9 line transitively caps illuminate/support at ^12.0; v3.2.2 declares ^12.0|^13.0). Backwards compatible — existing v2.9 installs continue to resolve. (#103)

CI

• Expanded the CI test job into a PHP × Laravel × blade-fontawesome matrix covering L10–L13 on PHP 8.2–8.4 with both blade-fontawesome v2 and v3, so future framework bumps are exercised before tag. Matrix is informational-only for this release (see #105 for the gating cleanup).

Changed

• Added Laravel 13 support by widening illuminate/support constraint to ^10.0|^11.0|^12.0|^13.0
• Widened orchestra/testbench dev constraint to ^8|^9|^10|^11 to enable testing against Laravel 13
• Added explicit php constraint of ^8.1 so Composer fails fast on unsupported PHP versions (the floor matches Laravel 10's PHP requirement; Laravel 11/12/13 transitively enforce higher floors)

Changed

• Updated artisanpack-ui/security constraint from ^1.0 to ^1.0|^2.0 to support ArtisanPack UI Security 2.0

Fixed

• Fixed alignment issue with the select component
• Guard toast JS call against missing function
• Fix CodeRabbit review findings from GitHub migration

• Initial test release of the ArtisanPack UI Livewire UI Components package.

• Added in typography components for heading, subheading, text and link.

• Added fixes for rendering the components.

• Fixed a problem with the theme generator CSS overwriting dark mode CSS variables.\n- Fixed a problem with color stops not being generated for primary, secondary and accent colors.

• Fixed styling for the sidebar on the main component.

• Fixed issues with tables and Livewire components.

• Updated the calendar component to be able to show events and event modals.

• Added a fix for the custom event modal for the calendar.

• Added in some various fixes to the package.

• Fixed issue with the rich text editor component.\n- Added in ability to customize the background for hover and active states for menu items.

• Fixed issue with the editor component.

• Added random color generator functionality.\n- Added icon options for accordion and collapse components.\n- Added card variant support for checkbox and radio components.\n- Added card figure positioning options.\n- Updated HR separator component.\n- Updated menu documentation.\n- Fixed calendar component issues.\n- Fixed Mary references throughout the codebase.

• Updated rating component functionality and accessibility.\n- Added image slider and image gallery components.\n- Updated carousel component with customizable icons and accessibility improvements.\n- Added support for vertical tabs.\n- Added customization options for stat component.\n- Added search functionality for tags component.\n- Added pagination component options.\n- Added drag-and-drop upload functionality for file and image library components.\n- Added custom icon support for ListItem and Loading components.\n- Added color and theme support for datepicker component.\n- Added color variants for avatar, alert, badge, button and toast components.\n- Added button component variants.\n- Repository cleanup and documentation improvements.

Release v1.0.0-beta1. Refer to CHANGELOG.md for detailed changes.

Release 1.0-beta2. Refer to CHANGELOG.md for detailed changes.

Release v1.0.0-beta3. Refer to CHANGELOG.md for detailed changes.

Release v1.0-beta4. Refer to CHANGELOG.md for detailed changes.

First Stable Release\nThis is the first stable release of ArtisanPack UI Livewire UI Components, a comprehensive UI component library for the TALL stack (Tailwind CSS, Alpine.js, Laravel, and Livewire).\n### Highlights\n- 77 Production-Ready Components: Complete library spanning form inputs, layout elements, navigation, data display, feedback, and utility components\n- Full Test Coverage: 1,567+ tests with 6,490 assertions ensuring reliability\n- Laravel 10, 11, and 12 Support: Future-proof compatibility with current and upcoming Laravel versions\n- Livewire 3.6+ Compatible: Built for the latest Livewire features\n- Tailwind CSS 4 and daisyUI: Modern styling with full dark mode support\n- Accessibility Focused: WCAG 2.1 compliant components\n- Comprehensive Documentation: Detailed guides and examples for every component\n### Component Categories\n- Form Components (25): Button, Input, Select, Checkbox, DatePicker, Editor, File upload, and more\n- Layout Components (11): Card, Modal, Tabs, Accordion, Drawer, Dropdown\n- Navigation Components (9): Menu, Breadcrumbs, Pagination, Spotlight Search\n- Data Display Components (22): Table, Chart, Calendar, Avatar, Badge, Progress\n- Feedback Components (4): Alert, Toast, Loading, Errors\n- Utility Components (6): Carousel, Icon, ThemeToggle, Swap\n### Migration from Beta\nIf upgrading from a beta version, no breaking changes are expected. The component API remains stable.\n---

Fixed\n- Demo views: Fixed image-gallery and image-slider demo views to use correct <x-artisanpack-*> component prefixes instead of incorrect <x-*> syntax\n- ColorGenerator: Removed unused `` variable and ArtisanPackUI\Accessibility\Facades\A11y import in generateThemeCss() method\n---

Fixed\n- Button component: Fixed loading state content (spinners, loading text/icons) showing in default state instead of only during loading\n- Changed from wire:loading to CSS-safe approach using class="hidden" with wire:loading.class.remove="hidden"\n- Ensures loading indicators are hidden by default via CSS, preventing flash of unstyled content\n- Loading content is now properly hidden on initial page render regardless of JavaScript initialization timing\n### Changed\n- Button documentation: Updated loading states section with recommended usage patterns and explanation of CSS-safe implementation\n---

Added\n#### Dashboard Components\n- KpiCard: New component for displaying KPIs with sparklines, trend indicators, and glass effects\n- Supports sparkline visualization (area, line, bar charts)\n- Automatic trend indicator coloring (green for positive, red for negative)\n- Glass effect support with customizable tints\n- Footer slot for additional content\n- WidgetGrid: Responsive grid helper for dashboard layouts\n- Configurable column count (1-6 columns)\n- Automatic responsive breakpoints\n- Configurable gap spacing\n- Sparkline: Inline sparkline chart component\n- Supports area, line, and bar chart types\n- Customizable colors\n#### Table Data Export\n- TableExporter: New utility class for exporting table data\n- CSV export (client-side)\n- XLSX export via PhpSpreadsheet (server-side)\n- PDF export via DomPDF (server-side)\n- Automatic header normalization for Table component format\n- Hidden column filtering\n- WithTableExport: New trait for Livewire components\n- Handles table-export-request events\n- Provides exportTableToCsv() and exportTableToXlsx() methods\n- Abstract getTableExportData() method for customization\n- Table component: New export props\n- exportable - Enable export functionality\n- export-formats - Configure available formats (csv, xlsx, pdf)\n- export-filename - Custom filename for exports\n#### Streaming Content (Livewire 4+)\n- StreamableContent: New component for displaying real-time streaming content\n- Supports Livewire 4's wire:stream directive\n- Blinking cursor animation option\n- Placeholder text support\n- Prose styling for rich text\n- Graceful degradation on Livewire 3\n#### Glass Effects\n- GlassHelper: New utility class for frosted glass UI effects\n- Three glass variants: frost, blur, subtle\n- Customizable tint colors with accessible text colors\n- WCAG 2.0 AA compliant contrast handling\n- GlassPresets: Six pre-built glass theme configurations\n- glass-frosted-light - Professional frosted glass for light backgrounds\n- glass-frosted-dark - Sophisticated frosted glass for dark backgrounds\n- glass-liquid-light - Premium liquid glass effect for light backgrounds\n- glass-liquid-dark - Dramatic liquid glass with enhanced glow\n- glass-minimal - Subtle, accessibility-friendly glass effect (adaptive)\n- glass-bold - Strong, prominent glass for CTAs and heroes (adaptive)\n- CSS class-based application system\n- Programmatic API for generating custom presets\n#### Accessibility & High Contrast Themes\n- HighContrastTheme: WCAG AAA compliant high-contrast theme system\n- high-contrast-light - Maximum contrast on light backgrounds (WCAG AAA)\n- high-contrast-dark - Maximum contrast on dark backgrounds (WCAG AAA)\n- enhanced-contrast-light - Improved contrast on light (WCAG AA)\n- enhanced-contrast-dark - Improved contrast on dark (WCAG AA)\n- Automatic prefers-contrast and prefers-reduced-motion media query support\n- Enhanced focus indicators for keyboard navigation\n- Text scaling classes (.text-larger, .text-extra-large)\n- Skip link styling for accessibility\n#### Theme Preview Tool\n- ThemePreview: Browser-based interactive theme customization tool\n- Real-time color adjustment with Tailwind colors or custom hex\n- Component preview gallery organized by category\n- Glass effect customization with presets and tint options\n- Accessibility preset selection\n- Dark mode toggle\n- Export to CSS or JSON\n- Shareable preview URLs with all settings encoded\n- Generated artisan command output\n- Available at /artisanpack/theme-preview route\n#### Livewire 4 Features\n- Table component: Native drag-and-drop sorting via wire:sort\n- sortable prop with sort handles\n- Cross-list dragging via sort-group\n- Table component: Infinite scroll via wire:intersect\n- infinite-scroll prop with customizable loading text\n- Modifier support (once, half, full)\n- LivewireHelper: Version detection utility for feature compatibility\n### Changed\n- Updated component count from 60+ to 70+ in documentation\n- Table component now supports associative array rows with automatic normalization\n- Updated home.md and components.md with v2.0 features\n- Added Dashboard Components category to documentation\n- GenerateThemeCss command: Enhanced with new options\n- --preset option for applying glass presets\n- --presets-only to generate only glass preset CSS\n- --high-contrast-only to generate only accessibility CSS\n- --accessibility-preset to apply specific accessibility preset\n- --no-high-contrast to skip high contrast CSS generation\n- --json to export theme configuration as JSON\n- --interactive mode for guided theme creation\n### Dependencies\n- Added phpoffice/phpspreadsheet as suggested dependency for XLSX export\n- Added barryvdh/laravel-dompdf as suggested dependency for PDF export\n### Notes\n- Livewire 4-specific features (wire:stream, wire:sort, wire:intersect) are gracefully ignored on Livewire 3\n- XLSX and PDF exports require optional dependencies to be installed\n- Theme preview tool available at /artisanpack/theme-preview (named route: artisanpack.theme-preview)\n- Glass presets use CSS custom properties for easy theming\n- High contrast themes respect system prefers-contrast and prefers-reduced-motion media queries\n- All v2.0 features are additive with no breaking changes from v1.x\n---

Added\n#### Dashboard Components\n- KpiCard: New component for displaying KPIs with sparklines, trend indicators, and glass effects\n- Supports sparkline visualization (area, line, bar charts)\n- Automatic trend indicator coloring (green for positive, red for negative)\n- Glass effect support with customizable tints\n- Footer slot for additional content\n- WidgetGrid: Responsive grid helper for dashboard layouts\n- Configurable column count (1-6 columns)\n- Automatic responsive breakpoints\n- Configurable gap spacing\n- Sparkline: Inline sparkline chart component\n- Supports area, line, and bar chart types\n- Customizable colors\n#### Table Data Export\n- TableExporter: New utility class for exporting table data\n- CSV export (client-side)\n- XLSX export via PhpSpreadsheet (server-side)\n- PDF export via DomPDF (server-side)\n- Automatic header normalization for Table component format\n- Hidden column filtering\n- WithTableExport: New trait for Livewire components\n- Handles table-export-request events\n- Provides exportTableToCsv() and exportTableToXlsx() methods\n- Abstract getTableExportData() method for customization\n- Table component: New export props\n- exportable - Enable export functionality\n- export-formats - Configure available formats (csv, xlsx, pdf)\n- export-filename - Custom filename for exports\n#### Streaming Content (Livewire 4+)\n- StreamableContent: New component for displaying real-time streaming content\n- Supports Livewire 4's wire:stream directive\n- Blinking cursor animation option\n- Placeholder text support\n- Prose styling for rich text\n- Graceful degradation on Livewire 3\n#### Glass Effects\n- GlassHelper: New utility class for frosted glass UI effects\n- Three glass variants: frost, blur, subtle\n- Customizable tint colors with accessible text colors\n- WCAG 2.0 AA compliant contrast handling\n- GlassPresets: Six pre-built glass theme configurations\n- glass-frosted-light - Professional frosted glass for light backgrounds\n- glass-frosted-dark - Sophisticated frosted glass for dark backgrounds\n- glass-liquid-light - Premium liquid glass effect for light backgrounds\n- glass-liquid-dark - Dramatic liquid glass with enhanced glow\n- glass-minimal - Subtle, accessibility-friendly glass effect (adaptive)\n- glass-bold - Strong, prominent glass for CTAs and heroes (adaptive)\n- CSS class-based application system\n- Programmatic API for generating custom presets\n#### Accessibility & High Contrast Themes\n- HighContrastTheme: WCAG AAA compliant high-contrast theme system\n- high-contrast-light - Maximum contrast on light backgrounds (WCAG AAA)\n- high-contrast-dark - Maximum contrast on dark backgrounds (WCAG AAA)\n- enhanced-contrast-light - Improved contrast on light (WCAG AA)\n- enhanced-contrast-dark - Improved contrast on dark (WCAG AA)\n- Automatic prefers-contrast and prefers-reduced-motion media query support\n- Enhanced focus indicators for keyboard navigation\n- Text scaling classes (.text-larger, .text-extra-large)\n- Skip link styling for accessibility\n#### Theme Preview Tool\n- ThemePreview: Browser-based interactive theme customization tool\n- Real-time color adjustment with Tailwind colors or custom hex\n- Component preview gallery organized by category\n- Glass effect customization with presets and tint options\n- Accessibility preset selection\n- Dark mode toggle\n- Export to CSS or JSON\n- Shareable preview URLs with all settings encoded\n- Generated artisan command output\n- Available at /artisanpack/theme-preview route\n#### Livewire 4 Features\n- Table component: Native drag-and-drop sorting via wire:sort\n- sortable prop with sort handles\n- Cross-list dragging via sort-group\n- Table component: Infinite scroll via wire:intersect\n- infinite-scroll prop with customizable loading text\n- Modifier support (once, half, full)\n- LivewireHelper: Version detection utility for feature compatibility\n### Changed\n- Updated component count from 60+ to 70+ in documentation\n- Table component now supports associative array rows with automatic normalization\n- Updated home.md and components.md with v2.0 features\n- Added Dashboard Components category to documentation\n- GenerateThemeCss command: Enhanced with new options\n- --preset option for applying glass presets\n- --presets-only to generate only glass preset CSS\n- --high-contrast-only to generate only accessibility CSS\n- --accessibility-preset to apply specific accessibility preset\n- --no-high-contrast to skip high contrast CSS generation\n- --json to export theme configuration as JSON\n- --interactive mode for guided theme creation\n### Dependencies\n- Added phpoffice/phpspreadsheet as suggested dependency for XLSX export\n- Added barryvdh/laravel-dompdf as suggested dependency for PDF export\n### Notes\n- Livewire 4-specific features (wire:stream, wire:sort, wire:intersect) are gracefully ignored on Livewire 3\n- XLSX and PDF exports require optional dependencies to be installed\n- Theme preview tool available at /artisanpack/theme-preview (named route: artisanpack.theme-preview)\n- Glass presets use CSS custom properties for easy theming\n- High contrast themes respect system prefers-contrast and prefers-reduced-motion media queries\n- All v2.0 features are additive with no breaking changes from v1.x\n---

Changed\n- Updated Livewire dependency constraint from ^3.6 to ^3.6|^4.0 to support Livewire 4.0\n---