feat: Plugin Foundation & Basic Models

.github/workflows/fix-php-code-style-issues.yml

@@ -14,7 +14,7 @@ jobs:
 
     steps:
       - name: Checkout code
-        uses: actions/checkout@v4
+        uses: actions/checkout@v5
         with:
           ref: ${{ github.head_ref }}
 

.github/workflows/phpstan.yml

@@ -11,12 +11,12 @@ jobs:
     name: phpstan
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v5
 
       - name: Setup PHP
         uses: shivammathur/setup-php@v2
         with:
-          php-version: '8.1'
+          php-version: '8.2'
           coverage: none
 
       - name: Install composer dependencies

.github/workflows/run-tests.yml

@@ -13,19 +13,19 @@ jobs:
       fail-fast: true
       matrix:
         os: [ubuntu-latest, windows-latest]
-        php: [8.2, 8.1]
-        laravel: [10.*]
+        php: [8.2, 8.3]
+        laravel: [11.*]
         stability: [prefer-lowest, prefer-stable]
         include:
-          - laravel: 10.*
-            testbench: 8.*
+          - laravel: 11.*
+            testbench: 9.*
             carbon: 2.*
 
     name: P${{ matrix.php }} - L${{ matrix.laravel }} - ${{ matrix.stability }} - ${{ matrix.os }}
 
     steps:
       - name: Checkout code
-        uses: actions/checkout@v4
+        uses: actions/checkout@v5
 
       - name: Setup PHP
         uses: shivammathur/setup-php@v2

.github/workflows/update-changelog.yml

@@ -13,7 +13,7 @@ jobs:
 
     steps:
       - name: Checkout code
-        uses: actions/checkout@v4
+        uses: actions/checkout@v5
         with:
           ref: main
 

composer.json

@@ -1,36 +1,39 @@
 {
-    "name": ":vendor_slug/:package_slug",
-    "description": ":package_description",
+    "name": "tapp/filament-library",
+    "description": "A Google Drive-like file management system for Filament",
     "keywords": [
-        ":vendor_name",
+        "tapp",
         "laravel",
-        ":package_slug"
+        "filament",
+        "library",
+        "file-management"
     ],
-    "homepage": "https://github.com/:vendor_slug/:package_slug",
+    "homepage": "https://github.com/TappNetwork/Filament-Library",
     "support": {
-        "issues": "https://github.com/:vendor_slug/:package_slug/issues",
-        "source": "https://github.com/:vendor_slug/:package_slug"
+        "issues": "https://github.com/TappNetwork/Filament-Library/issues",
+        "source": "https://github.com/TappNetwork/Filament-Library"
     },
     "license": "MIT",
     "authors": [
         {
-            "name": ":author_name",
-            "email": "author@domain.com",
+            "name": "Tapp Network",
+            "email": "dev@tappnetwork.com",
             "role": "Developer"
         }
     ],
     "require": {
         "php": "^8.1",
-        "filament/filament": "^3.0",
-        "filament/forms": "^3.0",
-        "filament/tables": "^3.0",
-        "spatie/laravel-package-tools": "^1.15.0"
+        "filament/filament": "^4.0",
+        "illuminate/contracts": "^10.0|^11.0",
+        "spatie/laravel-package-tools": "^1.15.0",
+        "spatie/laravel-medialibrary": "^11.0",
+        "filament/spatie-laravel-media-library-plugin": "^4.0"
     },
     "require-dev": {
         "laravel/pint": "^1.0",
-        "nunomaduro/collision": "^7.9",
+        "nunomaduro/collision": "^8.0",
         "nunomaduro/larastan": "^2.0.1",
-        "orchestra/testbench": "^8.0",
+        "orchestra/testbench": "^9.0",
         "pestphp/pest": "^2.1",
         "pestphp/pest-plugin-arch": "^2.0",
         "pestphp/pest-plugin-laravel": "^2.0",
@@ -41,13 +44,13 @@
     },
     "autoload": {
         "psr-4": {
-            "VendorName\\Skeleton\\": "src/",
-            "VendorName\\Skeleton\\Database\\Factories\\": "database/factories/"
+            "Tapp\\FilamentLibrary\\": "src/",
+            "Tapp\\FilamentLibrary\\Database\\Factories\\": "database/factories/"
         }
     },
     "autoload-dev": {
         "psr-4": {
-            "VendorName\\Skeleton\\Tests\\": "tests/"
+            "Tapp\\FilamentLibrary\\Tests\\": "tests/"
         }
     },
     "scripts": {
@@ -67,10 +70,10 @@
     "extra": {
         "laravel": {
             "providers": [
-                "VendorName\\Skeleton\\SkeletonServiceProvider"
+                "Tapp\\FilamentLibrary\\FilamentLibraryServiceProvider"
             ],
             "aliases": {
-                "Skeleton": "VendorName\\Skeleton\\Facades\\Skeleton"
+                "FilamentLibrary": "Tapp\\FilamentLibrary\\Facades\\FilamentLibrary"
             }
         }
     },

config/filament-library.php

@@ -0,0 +1,128 @@
+<?php
+
+return [
+    /*
+    |--------------------------------------------------------------------------
+    | Library Configuration
+    |--------------------------------------------------------------------------
+    |
+    | Configuration options for the Filament Library plugin.
+    |
+    */
+
+    /*
+    |--------------------------------------------------------------------------
+    | Maximum Nesting Depth
+    |--------------------------------------------------------------------------
+    |
+    | The maximum number of levels deep that folders can be nested.
+    | Set to null for unlimited nesting.
+    |
+    */
+    'max_nesting_depth' => 5,
+
+    /*
+    |--------------------------------------------------------------------------
+    | Soft Delete Days
+    |--------------------------------------------------------------------------
+    |
+    | Number of days to keep soft-deleted items before permanent deletion.
+    | Set to null to disable automatic cleanup.
+    |
+    */
+    'soft_delete_days' => 30,
+
+    /*
+    |--------------------------------------------------------------------------
+    | Table Columns
+    |--------------------------------------------------------------------------
+    |
+    | Configuration for which columns to show in the library table.
+    |
+    */
+    'table_columns' => [
+        'name' => true,
+        'type' => true,
+        'size' => true,
+        'created_at' => true,
+        'updated_at' => false,
+    ],
+
+    /*
+    |--------------------------------------------------------------------------
+    | File Operations
+    |--------------------------------------------------------------------------
+    |
+    | Configuration for file upload and handling.
+    |
+    */
+    'file_operations' => [
+        'allowed_mime_types' => [
+            'image/*',
+            'application/pdf',
+            'text/*',
+            'application/msword',
+            'application/vnd.openxmlformats-officedocument.wordprocessingml.document',
+            'application/vnd.ms-excel',
+            'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet',
+            'application/vnd.ms-powerpoint',
+            'application/vnd.openxmlformats-officedocument.presentationml.presentation',
+            'application/zip',
+            'application/x-rar-compressed',
+        ],
+        'max_file_size' => 50 * 1024 * 1024, // 50MB default
+    ],
+
+    /*
+    |--------------------------------------------------------------------------
+    | Media Library Configuration
+    |--------------------------------------------------------------------------
+    |
+    | Configuration for Spatie Media Library integration.
+    | Most settings are handled by the Media Library's own configuration.
+    |
+    */
+    'media_library' => [
+        'collection_name' => 'files',
+        'conversion_name' => 'thumb',
+        'disk' => null, // Use Media Library's default disk
+    ],
+
+    /*
+    |--------------------------------------------------------------------------
+    | Permission Configuration
+    |--------------------------------------------------------------------------
+    |
+    | Configuration for permission handling and caching.
+    |
+    */
+    'permissions' => [
+        'cache_ttl' => 3600, // 1 hour
+        'auto_inherit' => true, // Automatically inherit parent permissions
+        'cascade_on_change' => true, // Cascade permission changes to children
+    ],
+
+    /*
+    |--------------------------------------------------------------------------
+    | User Model Configuration
+    |--------------------------------------------------------------------------
+    |
+    | Configuration for user model integration.
+    |
+    */
+    'user_model' => \App\Models\User::class,
+
+    /*
+    |--------------------------------------------------------------------------
+    | Navigation Configuration
+    |--------------------------------------------------------------------------
+    |
+    | Configuration for Filament navigation integration.
+    |
+    */
+    'navigation' => [
+        'group' => 'Library',
+        'icon' => 'heroicon-o-folder',
+        'sort' => 10,
+    ],
+];

database/migrations/2024_01_01_000000_create_library_items_table.php

@@ -0,0 +1,36 @@
+<?php
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Support\Facades\Schema;
+
+return new class extends Migration
+{
+    /**
+     * Run the migrations.
+     */
+    public function up(): void
+    {
+        Schema::create('library_items', function (Blueprint $table) {
+            $table->id();
+            $table->string('name');
+            $table->string('slug');
+            $table->enum('type', ['folder', 'file']);
+            $table->foreignId('parent_id')->nullable()->constrained('library_items')->cascadeOnDelete();
+            $table->foreignId('created_by')->constrained('users');
+            $table->timestamps();
+            $table->softDeletes();
+
+            $table->index(['parent_id', 'type']);
+            $table->unique(['parent_id', 'slug'], 'lib_items_parent_slug_unique');
+        });
+    }
+
+    /**
+     * Reverse the migrations.
+     */
+    public function down(): void
+    {
+        Schema::dropIfExists('library_items');
+    }
+};

database/migrations/2024_01_01_000001_create_library_item_permissions_table.php

@@ -0,0 +1,32 @@
+<?php
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Support\Facades\Schema;
+
+return new class extends Migration
+{
+    /**
+     * Run the migrations.
+     */
+    public function up(): void
+    {
+        Schema::create('library_item_permissions', function (Blueprint $table) {
+            $table->id();
+            $table->foreignId('library_item_id')->constrained()->cascadeOnDelete();
+            $table->foreignId('user_id')->constrained()->cascadeOnDelete();
+            $table->enum('permission', ['view', 'edit']);
+            $table->timestamps();
+
+            $table->unique(['library_item_id', 'user_id', 'permission'], 'lib_item_perms_unique');
+        });
+    }
+
+    /**
+     * Reverse the migrations.
+     */
+    public function down(): void
+    {
+        Schema::dropIfExists('library_item_permissions');
+    }
+};