Add check for filament library

Author: andreia

composer.json

@@ -20,7 +20,7 @@
         "tapp/filament-form-builder": "^4.0"
     },
     "suggest": {
-        "tapp/filament-library": "Required for Library file / Library link step materials (enable filament-lms.integrations.filament_library)."
+        "tapp/filament-library": "Required for Library file / Library link step materials (set filament-lms.integrations.filament_library.enabled for the admin material picker)."
     },
     "require-dev": {
         "filament/upgrade": "^4.0",

resources/views/pages/step.blade.php

@@ -19,6 +19,18 @@
     @if (is_null($step->material_type))
         {{-- Intentionally text-only step: show the next button --}}
         <x-filament-lms::next-button />
+    @elseif (in_array($step->material_type, ['library_file', 'library_link'], true) && ! class_exists('Tapp\FilamentLibrary\Models\LibraryItem'))
+        {{-- Library morph types cannot be resolved without filament-library; avoid loading material() (fatal). --}}
+        <div class="flex items-center justify-center min-h-[60vh]">
+            <x-filament::card class="py-12 w-full max-w-md">
+                <div class="flex flex-col justify-center items-center text-center">
+                    <div class="mb-4 text-lg font-semibold text-red-600">
+                        This step uses library content, but the library package is not installed or unavailable.
+                    </div>
+                    <x-filament-lms::next-button :fixed="false" />
+                </div>
+            </x-filament::card>
+        </div>
     @elseif (is_null($step->material))
         {{-- Material type is set but material is missing (deleted): show error --}}
         <div class="flex items-center justify-center min-h-[60vh]">

src/FilamentLmsServiceProvider.php

@@ -85,8 +85,10 @@ public function packageBooted()
         Livewire::component('view-graded-entry', ViewGradedEntry::class);
         Livewire::component('image-step', ImageStep::class);
 
-        if (config('filament-lms.integrations.filament_library.enabled', false)
-            && class_exists(LibraryItem::class)) {
+        // Register library step components whenever the optional package is present.
+        // Config `integrations.filament_library.enabled` only gates admin UI (material picker);
+        // morph resolution and learner-facing steps must work for existing DB rows even when disabled.
+        if (class_exists(LibraryItem::class)) {
             Livewire::component('library-file-step', LibraryFileStep::class);
             Livewire::component('library-link-step', LibraryLinkStep::class);
         }
@@ -105,8 +107,7 @@ public function packageBooted()
             'image' => 'Tapp\FilamentLms\Models\Image',
         ];
 
-        if (config('filament-lms.integrations.filament_library.enabled', false)
-            && class_exists(LibraryItem::class)) {
+        if (class_exists(LibraryItem::class)) {
             $morphMap['library_file'] = LibraryItem::class;
             $morphMap['library_link'] = LibraryItem::class;
         }