diff --git a/src/Resources/views/infolists/components/previews/audio.blade.php b/src/Resources/views/infolists/components/previews/audio.blade.php
new file mode 100644
index 0000000..8d5e639
--- /dev/null
+++ b/src/Resources/views/infolists/components/previews/audio.blade.php
@@ -0,0 +1,7 @@
+
+
Audio Preview:
+
+
diff --git a/src/Resources/views/infolists/components/previews/download.blade.php b/src/Resources/views/infolists/components/previews/download.blade.php
new file mode 100644
index 0000000..737d242
--- /dev/null
+++ b/src/Resources/views/infolists/components/previews/download.blade.php
@@ -0,0 +1,19 @@
+
+
+
+ {{ $message }}
+
+
+
+
+ Download File
+
+
+
diff --git a/src/Resources/views/infolists/components/previews/image.blade.php b/src/Resources/views/infolists/components/previews/image.blade.php
new file mode 100644
index 0000000..c93d505
--- /dev/null
+++ b/src/Resources/views/infolists/components/previews/image.blade.php
@@ -0,0 +1 @@
+
diff --git a/src/Resources/views/infolists/components/previews/json-flashcards.blade.php b/src/Resources/views/infolists/components/previews/json-flashcards.blade.php
new file mode 100644
index 0000000..63ed07e
--- /dev/null
+++ b/src/Resources/views/infolists/components/previews/json-flashcards.blade.php
@@ -0,0 +1,38 @@
+@php
+ /** @var array
$data */
+ $data = $preview->parsedJson ?? [];
+ $title = is_string($data['title'] ?? null) ? $data['title'] : null;
+ $cards = is_array($data['cards'] ?? null) ? $data['cards'] : [];
+@endphp
+
+
+ @if($title)
+
{{ $title }}
+ @endif
+
+
+ @forelse($cards as $index => $card)
+ @if(! is_array($card))
+ @continue
+ @endif
+
+ @php
+ $front = $card['front'] ?? $card['term'] ?? $card['question'] ?? 'Card '.($index + 1);
+ $back = $card['back'] ?? $card['definition'] ?? $card['answer'] ?? '';
+ @endphp
+
+
+ @empty
+
No flashcards found in this file.
+ @endforelse
+
+
+ @include('filament-library::infolists.components.previews.partials.json-tree', [
+ 'data' => $data,
+ 'depth' => 0,
+ ])
+
diff --git a/src/Resources/views/infolists/components/previews/json-mindmap.blade.php b/src/Resources/views/infolists/components/previews/json-mindmap.blade.php
new file mode 100644
index 0000000..a8f5c12
--- /dev/null
+++ b/src/Resources/views/infolists/components/previews/json-mindmap.blade.php
@@ -0,0 +1,27 @@
+@php
+ /** @var array $data */
+ $data = $preview->parsedJson ?? [];
+ $title = is_string($data['title'] ?? null) ? $data['title'] : null;
+ $root = $data['root'] ?? $data;
+@endphp
+
+
+ @if($title)
+
{{ $title }}
+ @endif
+
+ @if(isset($data['nodes']) && is_array($data['nodes']))
+
+ @foreach($data['nodes'] as $node)
+ @if(! is_array($node))
+ @continue
+ @endif
+ -
+ {{ $node['label'] ?? $node['title'] ?? $node['name'] ?? $node['text'] ?? 'Node' }}
+
+ @endforeach
+
+ @else
+ @include('filament-library::infolists.components.previews.partials.mindmap-node', ['node' => $root, 'depth' => 0])
+ @endif
+
+ @if($title)
+
{{ $title }}
+ @endif
+
+ @forelse($questions as $index => $question)
+ @if(! is_array($question))
+ @continue
+ @endif
+
+ @php
+ $stem = $question['stem'] ?? $question['question'] ?? $question['text'] ?? 'Question '.($index + 1);
+ $options = $question['options'] ?? $question['choices'] ?? $question['answers'] ?? [];
+ $correct = $question['correct'] ?? $question['correct_answer'] ?? $question['answer'] ?? null;
+ @endphp
+
+
+
Question {{ $index + 1 }}
+
{{ $stem }}
+
+ @if(is_array($options) && $options !== [])
+
+ @foreach($options as $optionIndex => $option)
+ @php
+ $label = is_array($option)
+ ? ($option['text'] ?? $option['label'] ?? $option['value'] ?? json_encode($option))
+ : $option;
+ $isCorrect = $correct !== null && (
+ $correct === $option
+ || $correct === $optionIndex
+ || (is_array($option) && (($option['id'] ?? null) === $correct || ($option['value'] ?? null) === $correct))
+ );
+ @endphp
+ - $isCorrect])>
+ {{ $label }}
+ @if($isCorrect)
+ Correct
+ @endif
+
+ @endforeach
+
+ @endif
+
+ @empty
+
No questions found in this quiz file.
+ @endforelse
+
+ {!! $html !!}
+
diff --git a/src/Resources/views/infolists/components/previews/partials/json-tree.blade.php b/src/Resources/views/infolists/components/previews/partials/json-tree.blade.php
new file mode 100644
index 0000000..6e139af
--- /dev/null
+++ b/src/Resources/views/infolists/components/previews/partials/json-tree.blade.php
@@ -0,0 +1,39 @@
+@php
+ $isList = array_is_list($data);
+@endphp
+
+@if($isList)
+
+ @foreach($data as $index => $item)
+ -
+ [{{ $index }}]
+ @if(is_array($item))
+ @include('filament-library::infolists.components.previews.partials.json-tree', [
+ 'data' => $item,
+ 'depth' => $depth + 1,
+ ])
+ @else
+ {{ is_scalar($item) || $item === null ? (string) $item : json_encode($item) }}
+ @endif
+
+ @endforeach
+
+@else
+
+ @foreach($data as $key => $value)
+
+
- {{ $key }}
+ -
+ @if(is_array($value))
+ @include('filament-library::infolists.components.previews.partials.json-tree', [
+ 'data' => $value,
+ 'depth' => $depth + 1,
+ ])
+ @else
+ {{ is_scalar($value) || $value === null ? (string) $value : json_encode($value) }}
+ @endif
+
+
+ @endforeach
+
+@endif
diff --git a/src/Resources/views/infolists/components/previews/partials/mindmap-node.blade.php b/src/Resources/views/infolists/components/previews/partials/mindmap-node.blade.php
new file mode 100644
index 0000000..2adb0e6
--- /dev/null
+++ b/src/Resources/views/infolists/components/previews/partials/mindmap-node.blade.php
@@ -0,0 +1,30 @@
+@php
+ $label = is_array($node)
+ ? ($node['label'] ?? $node['title'] ?? $node['name'] ?? $node['text'] ?? null)
+ : (is_string($node) ? $node : null);
+ $children = is_array($node) && isset($node['children']) && is_array($node['children'])
+ ? $node['children']
+ : [];
+@endphp
+
+@if($label !== null)
+ 0) style="margin-left: {{ min($depth * 1.25, 6) }}rem;" @endif>
+ -
+ {{ $label }}
+
+ @foreach($children as $child)
+ @include('filament-library::infolists.components.previews.partials.mindmap-node', [
+ 'node' => $child,
+ 'depth' => $depth + 1,
+ ])
+ @endforeach
+
+
+@elseif($children !== [])
+ @foreach($children as $child)
+ @include('filament-library::infolists.components.previews.partials.mindmap-node', [
+ 'node' => $child,
+ 'depth' => $depth,
+ ])
+ @endforeach
+@endif
diff --git a/src/Resources/views/infolists/components/previews/pdf.blade.php b/src/Resources/views/infolists/components/previews/pdf.blade.php
new file mode 100644
index 0000000..5765d9a
--- /dev/null
+++ b/src/Resources/views/infolists/components/previews/pdf.blade.php
@@ -0,0 +1 @@
+
diff --git a/src/Resources/views/infolists/components/previews/video.blade.php b/src/Resources/views/infolists/components/previews/video.blade.php
new file mode 100644
index 0000000..068f68a
--- /dev/null
+++ b/src/Resources/views/infolists/components/previews/video.blade.php
@@ -0,0 +1,6 @@
+
+
+
diff --git a/src/Support/LibraryFileContentReader.php b/src/Support/LibraryFileContentReader.php
new file mode 100644
index 0000000..b94b563
--- /dev/null
+++ b/src/Support/LibraryFileContentReader.php
@@ -0,0 +1,37 @@
+size > $maxBytes) {
+ return null;
+ }
+
+ try {
+ $path = $media->getPath();
+
+ if (! is_readable($path)) {
+ return null;
+ }
+
+ $content = file_get_contents($path, false, null, 0, $maxBytes + 1);
+
+ if ($content === false || strlen($content) > $maxBytes) {
+ return null;
+ }
+
+ return $content;
+ } catch (\Throwable) {
+ return null;
+ }
+ }
+}
diff --git a/src/Support/LibraryFilePreview.php b/src/Support/LibraryFilePreview.php
new file mode 100644
index 0000000..cf97d45
--- /dev/null
+++ b/src/Support/LibraryFilePreview.php
@@ -0,0 +1,27 @@
+|null $parsedJson
+ */
+ public function __construct(
+ public readonly LibraryFilePreviewType $type,
+ public readonly string $mimeType,
+ public readonly string $extension,
+ public readonly ?string $textContent = null,
+ public readonly ?array $parsedJson = null,
+ public readonly ?string $fallbackMessage = null,
+ ) {}
+
+ public function isPreviewable(): bool
+ {
+ return $this->type->isPreviewable();
+ }
+}
diff --git a/src/Support/LibraryFilePreviewResolver.php b/src/Support/LibraryFilePreviewResolver.php
new file mode 100644
index 0000000..781b68a
--- /dev/null
+++ b/src/Support/LibraryFilePreviewResolver.php
@@ -0,0 +1,325 @@
+ */
+ private const PREVIEWABLE_IMAGES = ['jpg', 'jpeg', 'png', 'gif', 'webp', 'svg', 'bmp'];
+
+ /** @var list */
+ private const PREVIEWABLE_VIDEOS = ['mp4', 'webm', 'ogg', 'avi', 'mov'];
+
+ /** @var list */
+ private const PREVIEWABLE_AUDIO = ['mp3', 'wav', 'ogg', 'm4a', 'aac'];
+
+ /** @var list */
+ private const PDF_MIME_TYPES = ['application/pdf', 'application/x-pdf'];
+
+ public static function resolve(Media $media): LibraryFilePreview
+ {
+ $mimeType = strtolower((string) $media->mime_type);
+ $extension = self::resolveExtension($media);
+
+ if (self::isImage($mimeType, $extension)) {
+ return new LibraryFilePreview(LibraryFilePreviewType::Image, $mimeType, $extension);
+ }
+
+ if (self::isPdf($mimeType, $extension)) {
+ return new LibraryFilePreview(LibraryFilePreviewType::Pdf, $mimeType, $extension);
+ }
+
+ if (self::isVideo($mimeType, $extension)) {
+ return new LibraryFilePreview(LibraryFilePreviewType::Video, $mimeType, $extension);
+ }
+
+ if (self::isAudio($mimeType, $extension)) {
+ return new LibraryFilePreview(LibraryFilePreviewType::Audio, $mimeType, $extension);
+ }
+
+ if (self::isMarkdown($mimeType, $extension)) {
+ $content = LibraryFileContentReader::read($media);
+
+ if ($content === null) {
+ return self::unsupported(
+ $mimeType,
+ $extension,
+ 'This file is too large to preview. Please download to view.',
+ );
+ }
+
+ return new LibraryFilePreview(
+ LibraryFilePreviewType::Markdown,
+ $mimeType,
+ $extension,
+ textContent: $content,
+ );
+ }
+
+ if (self::isJson($mimeType, $extension)) {
+ return self::resolveJsonPreview($media, $mimeType, $extension);
+ }
+
+ return self::unsupported(
+ $mimeType,
+ $extension,
+ 'This file type cannot be previewed. Please download to view.',
+ );
+ }
+
+ public static function resolveExtension(Media $media): string
+ {
+ $fileNameExtension = strtolower(pathinfo((string) $media->file_name, PATHINFO_EXTENSION));
+
+ if ($fileNameExtension !== '') {
+ return $fileNameExtension;
+ }
+
+ return strtolower(pathinfo((string) $media->name, PATHINFO_EXTENSION));
+ }
+
+ private static function isImage(string $mimeType, string $extension): bool
+ {
+ return str_starts_with($mimeType, 'image/')
+ || in_array($extension, self::PREVIEWABLE_IMAGES, true);
+ }
+
+ private static function isPdf(string $mimeType, string $extension): bool
+ {
+ if (in_array($mimeType, self::PDF_MIME_TYPES, true)) {
+ return true;
+ }
+
+ return $extension === 'pdf';
+ }
+
+ private static function isVideo(string $mimeType, string $extension): bool
+ {
+ return str_starts_with($mimeType, 'video/')
+ || in_array($extension, self::PREVIEWABLE_VIDEOS, true);
+ }
+
+ private static function isAudio(string $mimeType, string $extension): bool
+ {
+ return str_starts_with($mimeType, 'audio/')
+ || in_array($extension, self::PREVIEWABLE_AUDIO, true);
+ }
+
+ private static function isMarkdown(string $mimeType, string $extension): bool
+ {
+ /** @var list $markdownExtensions */
+ $markdownExtensions = config('filament-library.preview.markdown_extensions', ['md', 'markdown', 'mdown']);
+
+ if (in_array($extension, $markdownExtensions, true)) {
+ return true;
+ }
+
+ return in_array($mimeType, ['text/markdown', 'text/x-markdown'], true);
+ }
+
+ private static function isJson(string $mimeType, string $extension): bool
+ {
+ return $extension === 'json'
+ || in_array($mimeType, ['application/json', 'text/json'], true);
+ }
+
+ private static function resolveJsonPreview(Media $media, string $mimeType, string $extension): LibraryFilePreview
+ {
+ $content = LibraryFileContentReader::read($media);
+
+ if ($content === null) {
+ return self::unsupported(
+ $mimeType,
+ $extension,
+ 'This file is too large to preview. Please download to view.',
+ );
+ }
+
+ try {
+ /** @var mixed $decoded */
+ $decoded = json_decode($content, true, 512, JSON_THROW_ON_ERROR);
+ } catch (\JsonException) {
+ return self::unsupported(
+ $mimeType,
+ $extension,
+ 'This JSON file could not be parsed. Please download to view.',
+ );
+ }
+
+ if (! is_array($decoded)) {
+ return new LibraryFilePreview(
+ LibraryFilePreviewType::JsonGeneric,
+ $mimeType,
+ $extension,
+ parsedJson: ['value' => $decoded],
+ );
+ }
+
+ $filenameHint = self::resolveJsonTypeFromFilename($media);
+ $schemaHint = self::resolveJsonTypeFromSchema($decoded);
+
+ $type = $filenameHint ?? $schemaHint ?? LibraryFilePreviewType::JsonGeneric;
+
+ return new LibraryFilePreview(
+ $type,
+ $mimeType,
+ $extension,
+ parsedJson: $decoded,
+ );
+ }
+
+ private static function resolveJsonTypeFromFilename(Media $media): ?LibraryFilePreviewType
+ {
+ $haystack = strtolower((string) $media->file_name . ' ' . (string) $media->name);
+
+ /** @var array> $patterns */
+ $patterns = config('filament-library.preview.json_filename_patterns', [
+ 'quiz' => ['quiz'],
+ 'flashcards' => ['flashcard', 'flashcards'],
+ 'mindmap' => ['mindmap', 'mind-map', 'mind_map'],
+ ]);
+
+ foreach ($patterns['quiz'] ?? ['quiz'] as $pattern) {
+ if (str_contains($haystack, strtolower($pattern))) {
+ return LibraryFilePreviewType::JsonQuiz;
+ }
+ }
+
+ foreach ($patterns['flashcards'] ?? ['flashcard', 'flashcards'] as $pattern) {
+ if (str_contains($haystack, strtolower($pattern))) {
+ return LibraryFilePreviewType::JsonFlashcards;
+ }
+ }
+
+ foreach ($patterns['mindmap'] ?? ['mindmap', 'mind-map', 'mind_map'] as $pattern) {
+ if (str_contains($haystack, strtolower($pattern))) {
+ return LibraryFilePreviewType::JsonMindmap;
+ }
+ }
+
+ return null;
+ }
+
+ /**
+ * @param array $decoded
+ */
+ private static function resolveJsonTypeFromSchema(array $decoded): ?LibraryFilePreviewType
+ {
+ if (self::looksLikeQuiz($decoded)) {
+ return LibraryFilePreviewType::JsonQuiz;
+ }
+
+ if (self::looksLikeFlashcards($decoded)) {
+ return LibraryFilePreviewType::JsonFlashcards;
+ }
+
+ if (self::looksLikeMindmap($decoded)) {
+ return LibraryFilePreviewType::JsonMindmap;
+ }
+
+ return null;
+ }
+
+ /**
+ * @param array $decoded
+ */
+ private static function looksLikeQuiz(array $decoded): bool
+ {
+ if (! isset($decoded['questions']) || ! is_array($decoded['questions'])) {
+ return false;
+ }
+
+ foreach ($decoded['questions'] as $question) {
+ if (! is_array($question)) {
+ continue;
+ }
+
+ $hasPrompt = isset($question['stem']) || isset($question['question']) || isset($question['text']);
+ $hasOptions = isset($question['options']) || isset($question['choices']) || isset($question['answers']);
+
+ if ($hasPrompt && $hasOptions) {
+ return true;
+ }
+ }
+
+ return false;
+ }
+
+ /**
+ * @param array $decoded
+ */
+ private static function looksLikeFlashcards(array $decoded): bool
+ {
+ if (! isset($decoded['cards']) || ! is_array($decoded['cards'])) {
+ return false;
+ }
+
+ foreach ($decoded['cards'] as $card) {
+ if (! is_array($card)) {
+ continue;
+ }
+
+ $hasFront = isset($card['front']) || isset($card['term']) || isset($card['question']);
+ $hasBack = isset($card['back']) || isset($card['definition']) || isset($card['answer']);
+
+ if ($hasFront && $hasBack) {
+ return true;
+ }
+ }
+
+ return false;
+ }
+
+ /**
+ * @param array $decoded
+ */
+ private static function looksLikeMindmap(array $decoded): bool
+ {
+ if (isset($decoded['nodes'], $decoded['edges']) && is_array($decoded['nodes'])) {
+ return true;
+ }
+
+ if (isset($decoded['root']) && is_array($decoded['root'])) {
+ return true;
+ }
+
+ if (self::hasNestedChildren($decoded)) {
+ return true;
+ }
+
+ return isset($decoded['children']) && is_array($decoded['children']);
+ }
+
+ /**
+ * @param array $decoded
+ */
+ private static function hasNestedChildren(array $decoded): bool
+ {
+ if (! isset($decoded['children']) || ! is_array($decoded['children'])) {
+ return false;
+ }
+
+ foreach ($decoded['children'] as $child) {
+ if (is_array($child) && (isset($child['children']) || isset($child['label']) || isset($child['title']) || isset($child['name']))) {
+ return true;
+ }
+ }
+
+ return false;
+ }
+
+ private static function unsupported(string $mimeType, string $extension, string $message): LibraryFilePreview
+ {
+ return new LibraryFilePreview(
+ LibraryFilePreviewType::Unsupported,
+ $mimeType,
+ $extension,
+ fallbackMessage: $message,
+ );
+ }
+}
diff --git a/src/Support/LibraryFolderBreadcrumbPath.php b/src/Support/LibraryFolderBreadcrumbPath.php
new file mode 100644
index 0000000..23939dd
--- /dev/null
+++ b/src/Support/LibraryFolderBreadcrumbPath.php
@@ -0,0 +1,115 @@
+
+ */
+ public static function ancestorsForParentId(?int $parentId): array
+ {
+ if ($parentId === null) {
+ return [];
+ }
+
+ $cacheKey = self::cacheKey($parentId);
+ $cacheTtl = (int) config('filament-library.cache.breadcrumbs_ttl_seconds', 300);
+
+ /** @var list $path */
+ $path = cache()->remember($cacheKey, $cacheTtl, function () use ($parentId): array {
+ return self::buildPath($parentId);
+ });
+
+ return $path;
+ }
+
+ /**
+ * @return list
+ */
+ public static function ancestorsForFolder(LibraryItem $folder): array
+ {
+ $folderId = $folder->getKey();
+
+ if (! is_int($folderId)) {
+ return self::buildPathFromFolder($folder);
+ }
+
+ $cacheKey = self::cacheKey($folderId);
+ $cacheTtl = (int) config('filament-library.cache.breadcrumbs_ttl_seconds', 300);
+
+ /** @var list $path */
+ $path = cache()->remember($cacheKey, $cacheTtl, function () use ($folder): array {
+ return self::buildPathFromFolder($folder);
+ });
+
+ return $path;
+ }
+
+ /**
+ * @return list
+ */
+ private static function buildPath(int $parentId): array
+ {
+ /** @var class-string $modelClass */
+ $modelClass = FilamentLibraryPlugin::libraryItemModelClass();
+
+ $folder = $modelClass::query()->find($parentId);
+
+ if ($folder === null) {
+ return [];
+ }
+
+ return self::buildPathFromFolder($folder);
+ }
+
+ /**
+ * @return list
+ */
+ private static function buildPathFromFolder(LibraryItem $folder): array
+ {
+ $path = [];
+ $current = $folder;
+
+ while ($current) {
+ $currentId = $current->getKey();
+
+ if (! is_int($currentId)) {
+ break;
+ }
+
+ array_unshift($path, [
+ 'id' => $currentId,
+ 'name' => (string) $current->name,
+ ]);
+
+ $current = $current->parent;
+ }
+
+ return $path;
+ }
+
+ private static function cacheKey(int $folderId): string
+ {
+ $tenantSegment = 'global';
+
+ if (config('filament-library.tenancy.enabled') && class_exists(Filament::class)) {
+ $tenant = Filament::getTenant();
+
+ if ($tenant !== null) {
+ $tenantKey = $tenant->getKey();
+ $tenantSegment = is_int($tenantKey) || is_string($tenantKey)
+ ? (string) $tenantKey
+ : 'global';
+ }
+ }
+
+ return "filament-library.breadcrumbs.{$tenantSegment}.{$folderId}";
+ }
+}
diff --git a/tests/Pest.php b/tests/Pest.php
index 5bca49f..8dc7e5e 100644
--- a/tests/Pest.php
+++ b/tests/Pest.php
@@ -2,4 +2,5 @@
use Tapp\FilamentLibrary\Tests\TestCase;
-uses(TestCase::class)->in(__DIR__);
+uses(TestCase::class)->in('Feature');
+uses(TestCase::class)->in('Unit');
diff --git a/tests/FilamentLibraryPluginTest.php b/tests/Unit/FilamentLibraryPluginTest.php
similarity index 100%
rename from tests/FilamentLibraryPluginTest.php
rename to tests/Unit/FilamentLibraryPluginTest.php
diff --git a/tests/Unit/LibraryFilePreviewResolverTest.php b/tests/Unit/LibraryFilePreviewResolverTest.php
new file mode 100644
index 0000000..62afeeb
--- /dev/null
+++ b/tests/Unit/LibraryFilePreviewResolverTest.php
@@ -0,0 +1,195 @@
+put($diskPath, $content);
+ }
+
+ $media = new Media(array_merge([
+ 'disk' => 'public',
+ 'conversions_disk' => 'public',
+ 'collection_name' => 'files',
+ 'manipulations' => [],
+ 'custom_properties' => [],
+ 'generated_conversions' => [],
+ 'responsive_images' => [],
+ ], $attributes));
+
+ if ($diskPath !== null) {
+ $media->forceFill([
+ 'id' => 1,
+ ]);
+
+ $media->setRawAttributes(array_merge($media->getAttributes(), [
+ 'id' => 1,
+ ]), true);
+
+ $fullPath = Storage::disk('public')->path($diskPath);
+
+ $media = Mockery::mock($media)->makePartial();
+ $media->shouldReceive('getPath')->andReturn($fullPath);
+ }
+
+ return $media;
+}
+
+it('detects pdf previews from file_name when display name lacks an extension', function (): void {
+ $media = previewMedia([
+ 'file_name' => 'hashed-slides.pdf',
+ 'name' => 'Q1 Sales Slides',
+ 'mime_type' => 'application/octet-stream',
+ 'size' => 1024,
+ ]);
+
+ $preview = LibraryFilePreviewResolver::resolve($media);
+
+ expect($preview->type)->toBe(LibraryFilePreviewType::Pdf)
+ ->and($preview->isPreviewable())->toBeTrue();
+});
+
+it('detects markdown previews and reads content from storage', function (): void {
+ $content = "# Atlas Notes\n\n- First point\n- Second point";
+
+ $media = previewMedia([
+ 'file_name' => 'notes.md',
+ 'name' => 'Atlas Notes',
+ 'mime_type' => 'text/markdown',
+ 'size' => strlen($content),
+ ], 'library/notes.md', $content);
+
+ $preview = LibraryFilePreviewResolver::resolve($media);
+
+ expect($preview->type)->toBe(LibraryFilePreviewType::Markdown)
+ ->and($preview->textContent)->toBe($content);
+});
+
+it('detects quiz json from filename patterns', function (): void {
+ $content = json_encode([
+ 'title' => 'Product Quiz',
+ 'questions' => [
+ [
+ 'stem' => 'What is Laravel?',
+ 'options' => ['A framework', 'A database'],
+ 'correct' => 'A framework',
+ ],
+ ],
+ ], JSON_THROW_ON_ERROR);
+
+ $media = previewMedia([
+ 'file_name' => 'topic-quiz.json',
+ 'name' => 'Topic Quiz',
+ 'mime_type' => 'application/json',
+ 'size' => strlen($content),
+ ], 'library/topic-quiz.json', $content);
+
+ $preview = LibraryFilePreviewResolver::resolve($media);
+
+ expect($preview->type)->toBe(LibraryFilePreviewType::JsonQuiz)
+ ->and($preview->parsedJson['title'] ?? null)->toBe('Product Quiz');
+});
+
+it('detects flashcards json from schema heuristics', function (): void {
+ $content = json_encode([
+ 'cards' => [
+ ['front' => 'Term', 'back' => 'Definition'],
+ ],
+ ], JSON_THROW_ON_ERROR);
+
+ $media = previewMedia([
+ 'file_name' => 'study-set.json',
+ 'name' => 'Study Set',
+ 'mime_type' => 'application/json',
+ 'size' => strlen($content),
+ ], 'library/study-set.json', $content);
+
+ $preview = LibraryFilePreviewResolver::resolve($media);
+
+ expect($preview->type)->toBe(LibraryFilePreviewType::JsonFlashcards);
+});
+
+it('detects mind map json from nested children', function (): void {
+ $content = json_encode([
+ 'title' => 'Topic Map',
+ 'label' => 'Root',
+ 'children' => [
+ ['label' => 'Branch A', 'children' => [['label' => 'Leaf']]],
+ ],
+ ], JSON_THROW_ON_ERROR);
+
+ $media = previewMedia([
+ 'file_name' => 'topic-mindmap.json',
+ 'name' => 'Topic Map',
+ 'mime_type' => 'application/json',
+ 'size' => strlen($content),
+ ], 'library/topic-mindmap.json', $content);
+
+ $preview = LibraryFilePreviewResolver::resolve($media);
+
+ expect($preview->type)->toBe(LibraryFilePreviewType::JsonMindmap);
+});
+
+it('falls back to unsupported when text content exceeds preview limit', function (): void {
+ config()->set('filament-library.preview.text_max_bytes', 10);
+
+ $content = str_repeat('a', 20);
+
+ $media = previewMedia([
+ 'file_name' => 'notes.md',
+ 'name' => 'Large Notes',
+ 'mime_type' => 'text/markdown',
+ 'size' => strlen($content),
+ ], 'library/large-notes.md', $content);
+
+ $preview = LibraryFilePreviewResolver::resolve($media);
+
+ expect($preview->type)->toBe(LibraryFilePreviewType::Unsupported)
+ ->and($preview->fallbackMessage)->toContain('too large');
+});
+
+it('falls back to unsupported when json is invalid', function (): void {
+ $content = '{not valid json';
+
+ $media = previewMedia([
+ 'file_name' => 'broken.json',
+ 'name' => 'Broken JSON',
+ 'mime_type' => 'application/json',
+ 'size' => strlen($content),
+ ], 'library/broken.json', $content);
+
+ $preview = LibraryFilePreviewResolver::resolve($media);
+
+ expect($preview->type)->toBe(LibraryFilePreviewType::Unsupported)
+ ->and($preview->fallbackMessage)->toContain('could not be parsed');
+});
+
+it('renders markdown preview blade with formatted html', function (): void {
+ $content = "# Heading\n\nParagraph text.";
+
+ $media = previewMedia([
+ 'file_name' => 'notes.md',
+ 'name' => 'Notes',
+ 'mime_type' => 'text/markdown',
+ 'size' => strlen($content),
+ ], 'library/notes.md', $content);
+
+ $preview = LibraryFilePreviewResolver::resolve($media);
+
+ $html = view('filament-library::infolists.components.previews.markdown', [
+ 'media' => $media,
+ 'fileUrl' => 'https://example.test/notes.md',
+ 'preview' => $preview,
+ ])->render();
+
+ expect($html)->toContain('and($html)->toContain('Paragraph text.');
+});
diff --git a/tests/Unit/LibraryFolderBreadcrumbPathTest.php b/tests/Unit/LibraryFolderBreadcrumbPathTest.php
new file mode 100644
index 0000000..6dbe9f9
--- /dev/null
+++ b/tests/Unit/LibraryFolderBreadcrumbPathTest.php
@@ -0,0 +1,35 @@
+ 4, 'name' => 'Atlas Preview Samples'],
+ ];
+
+ Cache::put('filament-library.breadcrumbs.global.4', $path, 300);
+
+ $cached = Cache::get('filament-library.breadcrumbs.global.4');
+
+ expect($cached)->toBe($path)
+ ->and($cached[0]['name'])->toBe('Atlas Preview Samples');
+});
+
+it('does not return incomplete class objects from breadcrumb cache', function (): void {
+ Cache::flush();
+
+ Cache::put('breadcrumbs_4', [(object) ['id' => 4]], 300);
+
+ $legacyCached = Cache::get('breadcrumbs_4');
+
+ expect($legacyCached[0])->toBeObject();
+
+ $path = LibraryFolderBreadcrumbPath::ancestorsForParentId(null);
+
+ expect($path)->toBe([]);
+});
diff --git a/tests/Unit/Pest.php b/tests/Unit/Pest.php
new file mode 100644
index 0000000..1aa56d1
--- /dev/null
+++ b/tests/Unit/Pest.php
@@ -0,0 +1,9 @@
+