feat: initial release of relaticle/comments

Filament comments package with:
- Polymorphic commenting on any Eloquent model
- Threaded replies with configurable depth
- @mentions with autocomplete and user search
- Emoji reactions with toggle and who-reacted tooltips
- File attachments via Livewire uploads
- Reply and mention notifications via Filament notification system
- Thread subscriptions for notification control
- Real-time broadcasting (opt-in Echo) with polling fallback
- Dark mode support
- CommentsAction, CommentsTableAction, CommentsEntry for Filament integration
- 204 tests, 421 assertions

src/Events/CommentCreated.php

@@ -0,0 +1,51 @@
+<?php
+
+namespace Relaticle\Comments\Events;
+
+use Illuminate\Broadcasting\InteractsWithBroadcasting;
+use Illuminate\Broadcasting\PrivateChannel;
+use Illuminate\Contracts\Broadcasting\ShouldBroadcast;
+use Illuminate\Database\Eloquent\Model;
+use Illuminate\Foundation\Events\Dispatchable;
+use Illuminate\Queue\SerializesModels;
+use Relaticle\Comments\Comment;
+use Relaticle\Comments\Config;
+
+class CommentCreated implements ShouldBroadcast
+{
+    use Dispatchable;
+    use InteractsWithBroadcasting;
+    use SerializesModels;
+
+    public readonly Model $commentable;
+
+    public function __construct(public readonly Comment $comment)
+    {
+        $this->commentable = $comment->commentable;
+    }
+
+    /** @return array<int, PrivateChannel> */
+    public function broadcastOn(): array
+    {
+        $prefix = Config::getBroadcastChannelPrefix();
+
+        return [
+            new PrivateChannel("{$prefix}.{$this->comment->commentable_type}.{$this->comment->commentable_id}"),
+        ];
+    }
+
+    public function broadcastWhen(): bool
+    {
+        return Config::isBroadcastingEnabled();
+    }
+
+    /** @return array{comment_id: int|string, commentable_type: string, commentable_id: int|string} */
+    public function broadcastWith(): array
+    {
+        return [
+            'comment_id' => $this->comment->id,
+            'commentable_type' => $this->comment->commentable_type,
+            'commentable_id' => $this->comment->commentable_id,
+        ];
+    }
+}

src/Events/CommentDeleted.php

@@ -0,0 +1,51 @@
+<?php
+
+namespace Relaticle\Comments\Events;
+
+use Illuminate\Broadcasting\InteractsWithBroadcasting;
+use Illuminate\Broadcasting\PrivateChannel;
+use Illuminate\Contracts\Broadcasting\ShouldBroadcast;
+use Illuminate\Database\Eloquent\Model;
+use Illuminate\Foundation\Events\Dispatchable;
+use Illuminate\Queue\SerializesModels;
+use Relaticle\Comments\Comment;
+use Relaticle\Comments\Config;
+
+class CommentDeleted implements ShouldBroadcast
+{
+    use Dispatchable;
+    use InteractsWithBroadcasting;
+    use SerializesModels;
+
+    public readonly Model $commentable;
+
+    public function __construct(public readonly Comment $comment)
+    {
+        $this->commentable = $comment->commentable;
+    }
+
+    /** @return array<int, PrivateChannel> */
+    public function broadcastOn(): array
+    {
+        $prefix = Config::getBroadcastChannelPrefix();
+
+        return [
+            new PrivateChannel("{$prefix}.{$this->comment->commentable_type}.{$this->comment->commentable_id}"),
+        ];
+    }
+
+    public function broadcastWhen(): bool
+    {
+        return Config::isBroadcastingEnabled();
+    }
+
+    /** @return array{comment_id: int|string, commentable_type: string, commentable_id: int|string} */
+    public function broadcastWith(): array
+    {
+        return [
+            'comment_id' => $this->comment->id,
+            'commentable_type' => $this->comment->commentable_type,
+            'commentable_id' => $this->comment->commentable_id,
+        ];
+    }
+}

src/Events/CommentReacted.php

@@ -0,0 +1,50 @@
+<?php
+
+namespace Relaticle\Comments\Events;
+
+use Illuminate\Broadcasting\InteractsWithBroadcasting;
+use Illuminate\Broadcasting\PrivateChannel;
+use Illuminate\Contracts\Broadcasting\ShouldBroadcast;
+use Illuminate\Foundation\Events\Dispatchable;
+use Illuminate\Queue\SerializesModels;
+use Relaticle\Comments\Comment;
+use Relaticle\Comments\Config;
+
+class CommentReacted implements ShouldBroadcast
+{
+    use Dispatchable;
+    use InteractsWithBroadcasting;
+    use SerializesModels;
+
+    public function __construct(
+        public readonly Comment $comment,
+        public readonly object $user,
+        public readonly string $reaction,
+        public readonly string $action,
+    ) {}
+
+    /** @return array<int, PrivateChannel> */
+    public function broadcastOn(): array
+    {
+        $prefix = Config::getBroadcastChannelPrefix();
+
+        return [
+            new PrivateChannel("{$prefix}.{$this->comment->commentable_type}.{$this->comment->commentable_id}"),
+        ];
+    }
+
+    public function broadcastWhen(): bool
+    {
+        return Config::isBroadcastingEnabled();
+    }
+
+    /** @return array{comment_id: int|string, reaction: string, action: string} */
+    public function broadcastWith(): array
+    {
+        return [
+            'comment_id' => $this->comment->id,
+            'reaction' => $this->reaction,
+            'action' => $this->action,
+        ];
+    }
+}

src/Events/CommentUpdated.php

@@ -0,0 +1,51 @@
+<?php
+
+namespace Relaticle\Comments\Events;
+
+use Illuminate\Broadcasting\InteractsWithBroadcasting;
+use Illuminate\Broadcasting\PrivateChannel;
+use Illuminate\Contracts\Broadcasting\ShouldBroadcast;
+use Illuminate\Database\Eloquent\Model;
+use Illuminate\Foundation\Events\Dispatchable;
+use Illuminate\Queue\SerializesModels;
+use Relaticle\Comments\Comment;
+use Relaticle\Comments\Config;
+
+class CommentUpdated implements ShouldBroadcast
+{
+    use Dispatchable;
+    use InteractsWithBroadcasting;
+    use SerializesModels;
+
+    public readonly Model $commentable;
+
+    public function __construct(public readonly Comment $comment)
+    {
+        $this->commentable = $comment->commentable;
+    }
+
+    /** @return array<int, PrivateChannel> */
+    public function broadcastOn(): array
+    {
+        $prefix = Config::getBroadcastChannelPrefix();
+
+        return [
+            new PrivateChannel("{$prefix}.{$this->comment->commentable_type}.{$this->comment->commentable_id}"),
+        ];
+    }
+
+    public function broadcastWhen(): bool
+    {
+        return Config::isBroadcastingEnabled();
+    }
+
+    /** @return array{comment_id: int|string, commentable_type: string, commentable_id: int|string} */
+    public function broadcastWith(): array
+    {
+        return [
+            'comment_id' => $this->comment->id,
+            'commentable_type' => $this->comment->commentable_type,
+            'commentable_id' => $this->comment->commentable_id,
+        ];
+    }
+}

src/Events/UserMentioned.php

@@ -0,0 +1,19 @@
+<?php
+
+namespace Relaticle\Comments\Events;
+
+use Illuminate\Database\Eloquent\Model;
+use Illuminate\Foundation\Events\Dispatchable;
+use Illuminate\Queue\SerializesModels;
+use Relaticle\Comments\Comment;
+
+class UserMentioned
+{
+    use Dispatchable;
+    use SerializesModels;
+
+    public function __construct(
+        public readonly Comment $comment,
+        public readonly Model $mentionedUser,
+    ) {}
+}