All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog,
and this project adheres to Semantic Versioning.

• No unreleased changes documented yet.

• Improved message link handling for email addresses, whitespace-preserving rendering, and dedicated link message parsing.
• More resilient unread indicator updates across active chat lists.

• Localized grouped chat dates and relative timestamps.
• Improved member action dropdown behavior so menus switch cleanly instead of stacking.
• Smoothed initial chat scroll behavior and refined chats input spacing.

• Prevented delete-for-everyone from rehydrating removed messages and causing 404s for other participants.
• Fixed realtime unread indicator sync and tightened loadMore and scroll stability in chat and chats-list views.

• Configurable unread indicator APIs and reactive chat preview badges.
• Configurable message link parsing with allowed TLD defaults and message-body URL parsing.

• Renamed the link parsing configuration to message_links and the internal parser to parseMessageUrls.

• Kept the widget chat drawer mounted across refreshes.
• Fixed undefined media handling and message action styling regressions.

• Fixed the send message action button background color.

• Widget wrapper UI props and refreshed dark palette options.

• Added Laravel 13 compatibility and aligned upload finalization with Livewire 4.
• Refactored model boot hooks to use booted() and renamed component style properties for consistency.

• Preserved image attachment detection for Livewire 3 and 4 uploads.
• Fixed modal and drawer layering plus scroll blocking when widgets or overlays are open.

• Panel chat actions now support custom icons and icon attributes.
• Improved tooltip accessibility, focus handling, and mobile touch support in header actions.
• Added cursor-pagination coverage plus configurable service model resolution and storage disk env support.

• Improved chats list pagination, rerender behavior, and responsive widget/sidebar interactions.
• Updated redirect-to-home handling and return controls for widget and mobile contexts.

• Fixed UUID-safe load-more ordering with deterministic cursor tie-breakers.
• Resolved icon rendering, attribute merge, and redirect rendering bugs in chats actions.

• Updated Wirechat to support Livewire v4.
• Improved internal component resolution for newer Livewire lifecycle behavior.
• Refined ChatWidget open/close handling for better stability.

• Updated and stabilized tests for Livewire v4.
• Fixed duplicate close events caused by multiple dispatches.

• Fixed rollback logic so legacy sendable_id and sendable_type fields are restored correctly.

• Improved internal message sender handling using participants instead of polymorphic fields.

• Rollback now correctly restores legacy sendable_id and sendable_type.
• General bug fixes and stability improvements.

• Compatible with Livewire v3.
• This line is maintenance-only (no new features).

• Added hasRoutes() support so panels can opt out of automatic route registration.

• Hardened auth-user access checks around route registration for the stable 0.3.0 release.

• A new feature registerRoutes(bool|Closure $condition = true) API on the Panel class.

• Reverted migrations that changed actionable_id, attachable_id and attachable_id to string in their respective tables.

• Excessive panel-related logging.

• Typos in CSS classes.

• Command to publish a migration to update actionable_id, attachable_id and attachable_id to string in their respective tables.

Transition from config-based to Panel-based settings for a cleaner, extensible way to define Wirechat environments.

• Introduced Panels as the new core system for managing chat environments (e.g., user, admin, support).
• New ChatsPanelProvider generator (php artisan make:wirechat-panel).
• wirechat:upgrade-namespace-to-v0.3x command to migrate Namu\WireChat → Wirechat\Wirechat.
• wirechat:upgrade-to-v0.3x command to migrate old config/wirechat.php to panel providers.
• wirechat:upgrade-morph-columns command to ensure polymorphic relations work with both UUID and bigint IDs.
• WireChatUser interface and InteractsWithWireChat trait for user models.
• TailwindCSS v4.0+ support.
• Panel-specific user search (searchUsersUsing) for flexible customization.
• Support for panel-based notifications with NotifyParticipant requiring panel IDs.

• Attachment URLs now resolve storage/visibility from the current panel.
• Improved avatar component: falls back to SVG when image load fails.
• Migrated searchChatables logic from User model → panel-based search.
• Storage configuration moved from attachments.* keys to new storage.* keys.
• UUID configuration clarified with uses_uuid_for_conversations key.
• Accessor methods renamed with wirechat prefix (getAvatarUrlAttribute → getWirechatAvatarUrlAttribute, etc.).
• Renamed Chatable trait → InteractsWithWireChat.

• Old namu/wirechat package (remove after upgrade).
• Legacy attachments.* config keys.
• Old uuids config key (replaced by uses_uuid_for_conversations).
• Old Chatable trait name (backwards-compatible for now).
• Legacy accessors (getAvatarUrlAttribute, getProfileUrlAttribute, getDisplayNameAttribute).

• Panel migration ensures existing config/wirechat.php customizations are preserved.
• Morph column upgrader ensures idempotent, safe migrations without breaking existing foreign keys.

• Fixed flickering overflow in the group creation flow.

• First alpha of the panel-based architecture, including panel providers, panel-aware search, and UUID migration tooling.
• Added emoji configuration options, language updates, and panel-aware route/channel resolution.

• Moved attachment URL resolution and UI settings into the panel system.

• Fixed avatar fallback behavior and a broad set of panel migration and test stability issues.

• Added French translations.

• Fixed long message text wrapping and minor translation cleanup.

• Fixed close button not working correctly when chat component is widget

• Added misssing closing tag in chat-list component

• uuids configuration option to toggle UUIDs for new installations

• Improved handling of storage URLs when saving attachments

• Encrypted parameter keys for Blade method actions to enhance security

• Changelog tag links missing prefix 'v'
• Style: in new-group button to use correct/updated css variable
• Failing tests

• New Theme documentation page.
• Support for defining CSS variables directly in a single theme configuration entry.

• Theme system now uses the new CSS variable-based theming approach.
• Improved file storage logic to better support S3 and disk visibility handling.

• wirechat.attachments.disk_visibility config option to determine if temporary URLs should be generated for private storage disks

• Attachment upload now uses single file uploads to support S3 and similar disks that do not handle temporary_uploaded_files with multiple files

• PHPStan errors and improved code style with docblocks

• Early Tailwind CSS v4 compatibility pass.

• Fixed the unwired description property regression.

• support for Tailwind v4

• Language file translation keys for labels
• Built-in validation translation keys
• Separate group info page for groups
• Empty search results message for the new chat component
• More tests

• Delete photo button incorrectly acting as a submit button while creating a group

• includes folder to partials in chats and chat directories

• Storeage url to use storage:disk()->url() instead of static url from database

• Storage disk to support dynamic storage

• Tests for multiple storage support

• Support for Laravel 12

• Introduced native notifications feature for new messages
• New notifications key to wirechat configuration

    'notifications'=>[
       'enabled'=>true,
       'main_sw_script' => 'sw.js',  // Relative to the public folder
    ],

• Added docs about notification

• Fixed emoji picker styling in system dark mode.

• New config variables:
  • 'guards' => ['web']
  • 'layout' => 'wirechat::layouts.app'
• Command for publishing views.
• Standalone Wirechat widget.
• Added/Improved documentation on:
  • Authorization
  • Core Components
  • Layout
  • Views
  • Contribution Guide
  • Extending Wirechat Components
• belongsToConversation middleware added to the /chats view route.

• NotifyParticipant channel now uses an encoded type and ID to support mixed models in conversations.

  Breaking Change:
  If you previously listened to the participant channel, update to the new format:

  + userId = @js(auth()->id());
  + encodedType = @js(Namu\Wirechat\Helpers\MorphClassResolver::encode(auth()->user()->getMorphClass()));
  
  - Echo.private(`participant.${userId}`)
  + Echo.private(`participant.${encodedType}.${userId}`)
        .listen('.Namu\\Wirechat\\Events\\NotifyParticipant', (e) => {
           console.log(e);
      });

• Folder Structure Reorganized

  We have restructured the package folders to group related components and assets more logically. This improves view publishing and feature additions. If you have previously published or customized views, please re-publish them using the new command and update any file path references accordingly.

• Updated tests to fully support conversations with mixed models.
• Improved participant handling for different models.

• Optimized code and queries for faster conversation loading.
• Updated brodcasting to use the guards provided in wirechat config the

• Introduced Actor and Actionable traits for improved polymorphic relationship handling.
  • Added tests for Actor and Actionable traits.

• Resolved a bug that caused incorrect retrieval of the authenticated participant due to a missing conversation_id filter during retrieval.

• Refactored migrations to use unsignedBigInteger. All polymorphic relationships now use unsignedBigInteger by default to maintain consistency across databases. This resolves a type mismatch issue found during testing on PostgreSQL.

Note: Running php artisan view:clear may be required to ensure the changes take effect.

• Fixed error caused by missing import in chat blade due to typo.
  Note: Running php artisan view:clear may be required to ensure the changes take effect.

• Fixed unread messages dot not appearing correctly.
  Note: Running php artisan view:clear may be required to ensure the changes take effect.

• Issue template
• MIT license
• CODEOWNERS file to assign reviewers automatically

• Cleaned up composer and test compatibility for the early Pest 2 and 3 support matrix.

• Added Pest 3 compatibility and moved read tracking to participants.
• Improved chats query performance and loading transitions.

• Introduced Wirechat package with the following features:
  • Basic chat functionality for private conversations.
  • Group Chats functionality.
  • Smart Deletes for:
    • Conversations
    • Messages
  • Messages: sending, receiving, viewing.
  • Published initial migrations for conversations and messages.