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

database/factories/CommentFactory.php

@@ -0,0 +1,34 @@
+<?php
+
+namespace Relaticle\Comments\Database\Factories;
+
+use Illuminate\Database\Eloquent\Factories\Factory;
+use Relaticle\Comments\Comment;
+
+class CommentFactory extends Factory
+{
+    protected $model = Comment::class;
+
+    /** @return array<string, mixed> */
+    public function definition(): array
+    {
+        return [
+            'body' => '<p>'.fake()->paragraph().'</p>',
+            'edited_at' => null,
+        ];
+    }
+
+    public function withParent(?Comment $parent = null): static
+    {
+        return $this->state(fn (array $attributes) => [
+            'parent_id' => $parent?->id,
+        ]);
+    }
+
+    public function edited(): static
+    {
+        return $this->state(fn (array $attributes) => [
+            'edited_at' => now(),
+        ]);
+    }
+}

database/migrations/create_comment_attachments_table.php.stub

@@ -0,0 +1,24 @@
+<?php
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Support\Facades\Schema;
+
+return new class extends Migration
+{
+    public function up(): void
+    {
+        Schema::create('comment_attachments', function (Blueprint $table) {
+            $table->id();
+            $table->foreignId('comment_id')
+                ->constrained(config('comments.tables.comments', 'comments'))
+                ->cascadeOnDelete();
+            $table->string('file_path');
+            $table->string('original_name');
+            $table->string('mime_type');
+            $table->unsignedBigInteger('size');
+            $table->string('disk');
+            $table->timestamps();
+        });
+    }
+};

database/migrations/create_comment_mentions_table.php.stub

@@ -0,0 +1,22 @@
+<?php
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Support\Facades\Schema;
+
+return new class extends Migration
+{
+    public function up(): void
+    {
+        Schema::create('comment_mentions', function (Blueprint $table) {
+            $table->id();
+            $table->foreignId('comment_id')
+                ->constrained(config('comments.tables.comments', 'comments'))
+                ->cascadeOnDelete();
+            $table->morphs('user');
+            $table->timestamps();
+
+            $table->unique(['comment_id', 'user_id', 'user_type']);
+        });
+    }
+};

database/migrations/create_comment_reactions_table.php.stub

@@ -0,0 +1,23 @@
+<?php
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Support\Facades\Schema;
+
+return new class extends Migration
+{
+    public function up(): void
+    {
+        Schema::create('comment_reactions', function (Blueprint $table) {
+            $table->id();
+            $table->foreignId('comment_id')
+                ->constrained(config('comments.tables.comments', 'comments'))
+                ->cascadeOnDelete();
+            $table->morphs('user');
+            $table->string('reaction');
+            $table->timestamps();
+
+            $table->unique(['comment_id', 'user_id', 'user_type', 'reaction']);
+        });
+    }
+};

database/migrations/create_comment_subscriptions_table.php.stub

@@ -0,0 +1,20 @@
+<?php
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Support\Facades\Schema;
+
+return new class extends Migration
+{
+    public function up(): void
+    {
+        Schema::create('comment_subscriptions', function (Blueprint $table) {
+            $table->id();
+            $table->morphs('commentable');
+            $table->morphs('user');
+            $table->timestamp('created_at')->nullable();
+
+            $table->unique(['commentable_type', 'commentable_id', 'user_type', 'user_id'], 'comment_subscriptions_unique');
+        });
+    }
+};

database/migrations/create_comments_table.php.stub

@@ -0,0 +1,27 @@
+<?php
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Support\Facades\Schema;
+
+return new class extends Migration
+{
+    public function up(): void
+    {
+        Schema::create(config('comments.tables.comments', 'comments'), function (Blueprint $table) {
+            $table->id();
+            $table->morphs('commentable');
+            $table->morphs('user');
+            $table->foreignId('parent_id')
+                ->nullable()
+                ->constrained(config('comments.tables.comments', 'comments'))
+                ->cascadeOnDelete();
+            $table->text('body');
+            $table->timestamp('edited_at')->nullable();
+            $table->softDeletes();
+            $table->timestamps();
+
+            $table->index(['commentable_type', 'commentable_id', 'parent_id']);
+        });
+    }
+};