Skip to content

A cross platform Audiobookshelf client for Android and iOS

Dart
33.5 KB
Raw Blame
import 'dart:async';
import 'dart:io';
import 'package:flutter/material.dart';
import '../services/player_settings.dart';
import '../services/progress_sync_service.dart';
import 'package:flutter/services.dart';
import 'package:provider/provider.dart';
import 'overlay_toast.dart';
import 'absorb_placement.dart';
import 'package:cached_network_image/cached_network_image.dart';
import 'package:cached_network_image_platform_interface/cached_network_image_platform_interface.dart'
    show ImageRenderMethodForWeb;
import '../l10n/app_localizations.dart';
import 'cover_badges.dart';
import '../services/wording.dart';
import '../providers/auth_provider.dart';
import '../providers/library_provider.dart';
import '../services/audio_player_service.dart';
import '../services/download_service.dart';
import '../screens/app_shell.dart';
import 'add_books_search_sheet.dart';
import 'book_detail_sheet.dart';
import 'books_sheet_shared.dart' show coverGridCount;
import 'editable_sheet_item.dart';
import 'episode_list_sheet.dart';
import 'stackable_sheet.dart';
import 'swipe_action.dart';

class PlaylistDetailSheet extends StatefulWidget {
  final String playlistId;
  final ScrollController? scrollController;

  const PlaylistDetailSheet({
    super.key,
    required this.playlistId,
    this.scrollController,
  });

  static void show(BuildContext context, String playlistId) {
    showStackableSheet(
      context: context,
      useSafeArea: true,
      showHandle: true,
      maxChildSize: 0.95,
      builder: (context, scrollController) => PlaylistDetailSheet(
        playlistId: playlistId,
        scrollController: scrollController,
      ),
    );
  }

  @override
  State<PlaylistDetailSheet> createState() => _PlaylistDetailSheetState();
}

class _PlaylistDetailSheetState extends State<PlaylistDetailSheet> {
  bool _editing = false;
  bool _gridView = false;
  List<Map<String, dynamic>>? _editItems;
  final Set<String> _selectedKeys = {}; // "libraryItemId" or "libraryItemId-episodeId"
  bool _isBatchUpdating = false;

  @override
  void initState() {
    super.initState();
    // Same list or grid choice as the Home section sheets, so the view you
    // picked last time comes back instead of the list every time.
    PlayerSettings.getSectionGridView().then((v) {
      if (mounted && v != _gridView) setState(() => _gridView = v);
    });
  }

  void _toggleGridView() {
    setState(() => _gridView = !_gridView);
    PlayerSettings.setSectionGridView(_gridView);
  }

  /// Find episode data from the playlist item's top-level 'episode' field,
  /// or from the library item's media.episodes array as fallback.
  Map<String, dynamic>? _findEpisode(Map<String, dynamic> playlistItem, Map<String, dynamic> libraryItem, String episodeId) {
    // Server includes episode as top-level field on playlist items
    final topEp = playlistItem['episode'] as Map<String, dynamic>?;
    if (topEp != null) return topEp;
    // Fallback: look in library item's episodes array
    final media = libraryItem['media'] as Map<String, dynamic>? ?? {};
    final episodes = media['episodes'] as List<dynamic>? ?? [];
    return episodes.cast<Map<String, dynamic>>().where(
      (e) => e['id'] == episodeId,
    ).firstOrNull;
  }

  /// Get episode title from playlist item data.
  String? _getEpisodeTitle(Map<String, dynamic> playlistItem, Map<String, dynamic> libraryItem, String episodeId) {
    return _findEpisode(playlistItem, libraryItem, episodeId)?['title'] as String?;
  }

  /// Open the correct detail sheet for a playlist item.
  void _openItem(Map<String, dynamic> playlistItem, Map<String, dynamic> libraryItem, String libraryItemId, String? episodeId) {
    if (episodeId != null) {
      final ep = _findEpisode(playlistItem, libraryItem, episodeId);
      if (ep != null) {
        EpisodeDetailSheet.show(
          context,
          libraryItem,
          ep,
          sourcePlaylistId: widget.playlistId,
        );
      } else {
        EpisodeListSheet.show(
          context,
          libraryItem,
          sourcePlaylistId: widget.playlistId,
          sourcePlaylistEpisodeId: episodeId,
        );
      }
    } else {
      showBookDetailSheet(
        context,
        libraryItemId,
        sourcePlaylistId: widget.playlistId,
      );
    }
  }

  String _itemKey(Map<String, dynamic> item) {
    final libraryItemId = item['libraryItemId'] as String? ?? '';
    final episodeId = item['episodeId'] as String?;
    return episodeId != null ? '$libraryItemId-$episodeId' : libraryItemId;
  }

  Future<void> _batchMarkFinished(bool finished, LibraryProvider lib) async {
    if (_selectedKeys.isEmpty) return;
    final api = context.read<AuthProvider>().apiService;
    if (api == null) return;

    setState(() => _isBatchUpdating = true);

    final playlist = lib.playlists.cast<Map<String, dynamic>>().where(
      (p) => p['id'] == widget.playlistId,
    ).firstOrNull;
    final items = (playlist?['items'] as List<dynamic>?) ?? [];

    for (final key in List<String>.from(_selectedKeys)) {
      final item = items.cast<Map<String, dynamic>>().where(
        (i) => _itemKey(i) == key,
      ).firstOrNull;
      if (item == null) continue;

      final libraryItemId = item['libraryItemId'] as String? ?? '';
      final episodeId = item['episodeId'] as String?;
      final libraryItem = item['libraryItem'] as Map<String, dynamic>?;
      final media = libraryItem?['media'] as Map<String, dynamic>? ?? {};
      final duration = (media['duration'] as num?)?.toDouble() ?? 0;

      if (episodeId != null) {
        if (finished) {
          final pushed = await api.updateEpisodeProgress(libraryItemId, episodeId,
            currentTime: duration, duration: duration, isFinished: true);
          if (!pushed) {
            await ProgressSyncService().saveFinishedOffline('$libraryItemId-$episodeId', duration);
          }
          lib.markFinishedLocally('$libraryItemId-$episodeId', skipAutoAdvance: true);
        } else {
          final pd = lib.getProgressData('$libraryItemId-$episodeId');
          final ct = (pd?['currentTime'] as num?)?.toDouble() ?? 0;
          await api.updateEpisodeProgress(libraryItemId, episodeId,
            currentTime: ct, duration: duration, isFinished: false);
          await lib.markNotFinishedLocally('$libraryItemId-$episodeId');
        }
      } else {
        if (finished) {
          try {
            await api.markFinished(libraryItemId, duration);
          } catch (_) {
            await ProgressSyncService().saveFinishedOffline(libraryItemId, duration);
          }
          lib.markFinishedLocally(libraryItemId, skipAutoAdvance: true);
        } else {
          final pd = lib.getProgressData(libraryItemId);
          final ct = (pd?['currentTime'] as num?)?.toDouble() ?? 0;
          await api.markNotFinished(libraryItemId, currentTime: ct, duration: duration);
          await lib.markNotFinishedLocally(libraryItemId);
        }
      }
    }

    await lib.refresh();
    if (mounted) {
      final count = _selectedKeys.length;
      final l = AppLocalizations.of(context)!;
      setState(() {
        _isBatchUpdating = false;
        _selectedKeys.clear();
      });
      showOverlayToast(
        context,
        finished
            ? l.playlistDetailItemsMarkedFinished(count)
            : l.playlistDetailItemsMarkedUnfinished(count),
        icon: finished ? Icons.check_circle_rounded : Icons.undo_rounded,
      );
    }
  }

  Future<void> _batchRemove(LibraryProvider lib) async {
    if (_selectedKeys.isEmpty) return;
    setState(() => _isBatchUpdating = true);

    final items = _editItems ?? [];
    final removedKeys = <String>{};

    for (final key in List<String>.from(_selectedKeys)) {
      final item = items.where(
        (i) => _itemKey(i) == key,
      ).firstOrNull;
      if (item == null) continue;
      final libraryItemId = item['libraryItemId'] as String? ?? '';
      final episodeId = item['episodeId'] as String?;
      if (await lib.removeFromPlaylist(
        widget.playlistId, libraryItemId, episodeId: episodeId,
      )) {
        removedKeys.add(key);
      }
    }

    if (mounted) {
      final count = removedKeys.length;
      final l = AppLocalizations.of(context)!;
      setState(() {
        _isBatchUpdating = false;
        _editItems?.removeWhere((item) => removedKeys.contains(_itemKey(item)));
        _selectedKeys.removeAll(removedKeys);
      });
      if (count > 0) {
        showOverlayToast(
          context,
          l.playlistDetailItemsRemoved(count),
          icon: Icons.playlist_remove_rounded,
        );
      }
    }
  }

  void _openAddBooks(LibraryProvider lib, Map<String, dynamic> playlist,
      String name, List<dynamic> items) {
    final libraryId = playlist['libraryId'] as String? ?? lib.selectedLibraryId;
    if (libraryId == null) return;
    // Only plain books count as members here (episodes use a different add flow).
    final memberIds = items
        .whereType<Map<String, dynamic>>()
        .where((i) => i['episodeId'] == null)
        .map((i) => i['libraryItemId'] as String? ?? '')
        .where((id) => id.isNotEmpty)
        .toSet();
    AddBooksSearchSheet.show(
      context,
      title: name,
      libraryId: libraryId,
      initialMemberIds: memberIds,
      onAdd: (id) => lib.addToPlaylist(widget.playlistId, id),
      onRemove: (id) => lib.removeFromPlaylist(widget.playlistId, id),
    );
  }

  /// Header icon with a comfortable (>=44px tall) tap target and ripple, so
  /// the small top-row controls aren't fiddly to press.
  Widget _headerIconButton(ColorScheme cs, IconData icon, VoidCallback onTap,
      {String? tooltip, Color? color}) {
    return IconButton(
      icon: Icon(icon, size: 20, color: color ?? cs.onSurfaceVariant),
      onPressed: onTap,
      tooltip: tooltip,
      constraints: const BoxConstraints(minWidth: 32, minHeight: 44),
      style: IconButton.styleFrom(
        visualDensity: VisualDensity.compact,
        tapTargetSize: MaterialTapTargetSize.shrinkWrap,
        padding: const EdgeInsets.symmetric(horizontal: 4, vertical: 10),
      ),
    );
  }

  Widget _headerTextButton(ColorScheme cs, String label, VoidCallback? onTap,
      {required Color color}) {
    return TextButton(
      onPressed: onTap,
      style: TextButton.styleFrom(
        foregroundColor: color,
        minimumSize: const Size(0, 44),
        padding: const EdgeInsets.symmetric(horizontal: 12, vertical: 10),
        tapTargetSize: MaterialTapTargetSize.shrinkWrap,
      ),
      child: Text(label, style: const TextStyle(fontWeight: FontWeight.w600)),
    );
  }

  Future<void> _deletePlaylist(BuildContext context, LibraryProvider lib) async {
    final l = AppLocalizations.of(context)!;
    final confirmed = await showDialog<bool>(
      context: context,
      builder: (ctx) => AlertDialog(
        title: Text(l.deletePlaylist),
        content: Text(l.deletePlaylistContent),
        actions: [
          TextButton(
            onPressed: () => Navigator.pop(ctx, false),
            child: Text(l.cancel),
          ),
          TextButton(
            onPressed: () => Navigator.pop(ctx, true),
            child: Text(l.delete),
          ),
        ],
      ),
    );
    if (confirmed == true && context.mounted) {
      await lib.deletePlaylist(widget.playlistId);
      if (context.mounted) Navigator.pop(context);
    }
  }

  void _startEdit(List<dynamic> items) {
    setState(() {
      _editing = true;
      _editItems = items
          .map((i) => Map<String, dynamic>.from(i as Map))
          .toList();
      _selectedKeys.clear();
    });
  }

  void _saveEdit(LibraryProvider lib) {
    final items = _editItems;
    if (items != null) {
      // Persist in the background so "Done" closes instantly instead of
      // hanging on the PATCH + playlists reload.
      unawaited(lib.reorderPlaylistItems(widget.playlistId, items));
    }
    Navigator.pop(context);
  }

  void _cancelEdit() {
    setState(() {
      _editing = false;
      _editItems = null;
      _selectedKeys.clear();
    });
  }

  @override
  Widget build(BuildContext context) {
    final cs = Theme.of(context).colorScheme;
    final tt = Theme.of(context).textTheme;
    final l = AppLocalizations.of(context)!;
    final lib = context.watch<LibraryProvider>();

    final playlist = lib.playlists.cast<Map<String, dynamic>>().where(
      (p) => p['id'] == widget.playlistId,
    ).firstOrNull;

    if (playlist == null) {
      return ListView(controller: widget.scrollController, children: [
        const SizedBox(height: 80),
        Center(child: Text(l.playlistNotFound)),
      ]);
    }

    final name = playlist['name'] as String? ?? l.playlistDetailDefaultName;
    final items = (playlist['items'] as List<dynamic>?) ?? [];
    // The add-books search only finds books, so hide it for podcast playlists.
    final isPodcastPlaylist = lib.libraries
            .cast<Map<String, dynamic>>()
            .where((lb) => lb['id'] == playlist['libraryId'])
            .map((lb) => (lb['mediaType'] as String? ?? 'book') == 'podcast')
            .firstOrNull ??
        lib.isPodcastLibrary;

    return Column(children: [
      const SizedBox(height: 4),
      Padding(
        padding: const EdgeInsets.symmetric(horizontal: 20),
        child: Row(children: [
          if (_editing) ...[
            _headerTextButton(cs, l.cancel, _cancelEdit, color: cs.onSurfaceVariant),
            const Spacer(),
            Flexible(
              child: Text(
                _selectedKeys.isEmpty
                    ? name
                    : l.selectedCount(_selectedKeys.length),
                maxLines: 1, overflow: TextOverflow.ellipsis,
                style: tt.titleMedium?.copyWith(
                  fontWeight: FontWeight.w600, color: cs.onSurface)),
            ),
            const Spacer(),
            _headerTextButton(
              cs,
              l.done,
              _isBatchUpdating ? null : () => _saveEdit(lib),
              color: cs.primary,
            ),
          ] else ...[
            Icon(Icons.playlist_play_rounded, size: 20, color: cs.primary),
            const SizedBox(width: 8),
            Expanded(
              child: Text(name, style: tt.titleMedium?.copyWith(
                fontWeight: FontWeight.w600, color: cs.onSurface,
              )),
            ),
            Text(l.playlistDetailItemCount(items.length),
              style: tt.labelSmall?.copyWith(color: cs.onSurfaceVariant),
            ),
            if (!isPodcastPlaylist)
              _headerIconButton(cs, Icons.library_add_rounded,
                () => _openAddBooks(lib, playlist, name, items)),
            _headerIconButton(cs,
              lib.isRollingDownloadEnabled(widget.playlistId)
                  ? Icons.downloading_rounded
                  : Icons.download_outlined,
              () => lib.toggleRollingDownload(widget.playlistId,
                  name: name, kind: 'playlist'),
              tooltip: lib.isRollingDownloadEnabled(widget.playlistId)
                  ? l.turnAutoDownloadOff
                  : l.turnAutoDownloadOn),
            _headerIconButton(cs,
              _gridView ? Icons.view_list_rounded : Icons.grid_view_rounded,
              _toggleGridView),
            _headerIconButton(cs, Icons.edit_rounded, () => _startEdit(items),
              tooltip: l.edit),
          ],
        ]),
      ),
      const SizedBox(height: 12),
      Divider(height: 1, color: cs.outlineVariant.withValues(alpha: 0.3),
        indent: 20, endIndent: 20),
      if (!_editing)
        _buildPlayButton(cs, lib, items, l),
      // Content
      Expanded(
        child: _editing
            ? _buildEditList(cs, tt, lib, l)
            : _gridView
                ? _buildGrid(cs, tt, lib, items, l)
                : _buildItemList(cs, tt, lib, items, l),
      ),
      if (_editing)
        Container(
          width: double.infinity,
          padding: EdgeInsets.fromLTRB(16, 8, 16, 8 + MediaQuery.of(context).viewPadding.bottom),
          decoration: BoxDecoration(
            color: cs.surfaceContainer,
            border: Border(top: BorderSide(color: cs.outlineVariant.withValues(alpha: 0.3))),
          ),
          child: _isBatchUpdating
              ? Center(child: SizedBox(width: 20, height: 20,
                  child: CircularProgressIndicator(strokeWidth: 2, color: cs.primary)))
              : _selectedKeys.isNotEmpty
                  ? Row(children: [
                  Expanded(child: FilledButton.tonalIcon(
                    onPressed: () => _batchMarkFinished(true, lib),
                    icon: const Icon(Icons.check_circle_rounded, size: 18),
                    label: Text(l.finished),
                    style: FilledButton.styleFrom(visualDensity: VisualDensity.compact),
                  )),
                  const SizedBox(width: 8),
                  Expanded(child: OutlinedButton.icon(
                    onPressed: () => _batchMarkFinished(false, lib),
                    icon: const Icon(Icons.radio_button_unchecked_rounded, size: 18),
                    label: Text(l.playlistDetailUnfinished),
                    style: OutlinedButton.styleFrom(visualDensity: VisualDensity.compact),
                  )),
                  const SizedBox(width: 8),
                  IconButton(
                    onPressed: () => _batchRemove(lib),
                    icon: Icon(Icons.playlist_remove_rounded, color: cs.error),
                    tooltip: l.playlistDetailRemoveFromPlaylist,
                    style: IconButton.styleFrom(
                      backgroundColor: cs.error.withValues(alpha: 0.1),
                    ),
                  ),
                ])
                  : OutlinedButton.icon(
                      onPressed: () => _deletePlaylist(context, lib),
                      icon: const Icon(Icons.delete_outline_rounded),
                      label: Text(l.deletePlaylist),
                      style: OutlinedButton.styleFrom(foregroundColor: cs.error),
                    ),
        ),
    ]);
  }

  Widget _buildPlayButton(
    ColorScheme cs,
    LibraryProvider lib,
    List<dynamic> items,
    AppLocalizations l,
  ) {
    final firstIdx = lib.firstUnfinishedPlaylistIndex(items);
    final allFinished = items.isNotEmpty && firstIdx < 0;
    final enabled = items.isNotEmpty && firstIdx >= 0;
    return Padding(
      padding: const EdgeInsets.fromLTRB(20, 12, 20, 4),
      child: SizedBox(
        width: double.infinity,
        child: FilledButton.icon(
          onPressed: enabled
              ? () async {
                  HapticFeedback.selectionClick();
                  // Pop the sheet first; otherwise auto-expand pushes the
                  // expanded player on top of us and our pop closes it.
                  final playlistId = widget.playlistId;
                  Navigator.pop(context);
                  AppShell.goToAbsorbingGlobal();
                  await PlayerSettings.setQueueModePlaylist(playlistId);
                  final started = await lib.playPlaylistFromStart(playlistId);
                  if (started) {
                    unawaited(lib.syncQueueAutoDownloads());
                  } else {
                    unawaited(
                      PlayerSettings.clearQueueModePlaylistIfActive(playlistId),
                    );
                  }
                }
              : null,
          icon: Icon(allFinished
              ? Icons.check_circle_outline_rounded
              : Icons.play_arrow_rounded),
          label: Text(allFinished ? l.playlistAllFinished : l.playlistPlayAction),
        ),
      ),
    );
  }

  Widget _buildEditList(ColorScheme cs, TextTheme tt, LibraryProvider lib, AppLocalizations l) {
    final items = _editItems!;
    return ReorderableListView.builder(
      padding: const EdgeInsets.only(top: 8, bottom: 8),
      onReorderStart: (_) => HapticFeedback.mediumImpact(),
      onReorder: (oldIndex, newIndex) {
        setState(() {
          if (newIndex > oldIndex) newIndex--;
          final item = items.removeAt(oldIndex);
          items.insert(newIndex, item);
        });
      },
      itemCount: items.length,
      itemBuilder: (context, index) {
        final item = items[index];
        final libraryItemId = item['libraryItemId'] as String? ?? '';
        final episodeId = item['episodeId'] as String?;
        final libraryItem = item['libraryItem'] as Map<String, dynamic>?;
        if (libraryItem == null) {
          return SizedBox.shrink(key: ValueKey('$libraryItemId-${episodeId ?? ''}-$index'));
        }

        final media = libraryItem['media'] as Map<String, dynamic>? ?? {};
        final metadata = media['metadata'] as Map<String, dynamic>? ?? {};
        final title = metadata['title'] as String? ?? l.unknown;
        final author = metadata['authorName'] as String? ?? '';
        final coverUrl = lib.getCoverUrl(libraryItemId);
        final itemKey = _itemKey(item);

        String? episodeTitle;
        if (episodeId != null) {
          episodeTitle = _getEpisodeTitle(item, libraryItem, episodeId);
        }

        return EditableSheetItem(
          key: ValueKey(itemKey),
          index: index,
          selected: _selectedKeys.contains(itemKey),
          onSelectedChanged: (selected) => setState(() {
            if (selected) {
              _selectedKeys.add(itemKey);
            } else {
              _selectedKeys.remove(itemKey);
            }
          }),
          title: episodeTitle ?? title,
          subtitle: episodeTitle != null ? title : (author.isEmpty ? null : author),
          leading: Stack(children: [
            ClipRRect(
              borderRadius: BorderRadius.circular(4),
              child: coverUrl != null
                  ? (coverUrl.startsWith('/')
                      ? Image.file(File(coverUrl), fit: BoxFit.cover,
                          width: 36, height: 36,
                          errorBuilder: (_, __, ___) => _placeholder(cs))
                      : Image.network(coverUrl, fit: BoxFit.cover,
                          width: 36, height: 36,
                          headers: lib.mediaHeaders,
                          errorBuilder: (_, __, ___) => _placeholder(cs)))
                  : _placeholder(cs),
            ),
            if (PlayerSettings.showExplicitBadge && metadata['explicit'] == true)
              Positioned(
                top: 2, right: 2,
                child: Container(
                  padding: const EdgeInsets.symmetric(horizontal: 3, vertical: 0.5),
                  decoration: BoxDecoration(
                    color: Colors.red.withValues(alpha: 0.85),
                    borderRadius: BorderRadius.circular(3),
                  ),
                  child: Text(l.bookCardExplicitBadge, style: const TextStyle(color: Colors.white, fontSize: 7, fontWeight: FontWeight.w800)),
                ),
              ),
          ]),
        );
      },
    );
  }

  Widget _buildItemList(ColorScheme cs, TextTheme tt, LibraryProvider lib, List<dynamic> items, AppLocalizations l) {
    return ListView.builder(
      controller: widget.scrollController,
      padding: const EdgeInsets.symmetric(horizontal: 16, vertical: 4).copyWith(bottom: 40),
      itemCount: items.length,
      itemBuilder: (context, index) {
        final item = items[index] as Map<String, dynamic>;
        final libraryItemId = item['libraryItemId'] as String? ?? '';
        final episodeId = item['episodeId'] as String?;
        final libraryItem = item['libraryItem'] as Map<String, dynamic>?;

        if (libraryItem == null) return const SizedBox.shrink();

        final media = libraryItem['media'] as Map<String, dynamic>? ?? {};
        final metadata = media['metadata'] as Map<String, dynamic>? ?? {};
        final title = metadata['title'] as String? ?? l.unknown;
        final author = metadata['authorName'] as String? ?? '';
        final coverUrl = lib.getCoverUrl(libraryItemId);
        final progressKey = episodeId != null ? '$libraryItemId-$episodeId' : libraryItemId;
        final progress = lib.getProgress(progressKey);
        final isFinished = lib.getProgressData(progressKey)?['isFinished'] == true;
        final isSkimmed = lib.getProgressData(progressKey)?['skimmed'] == true;
        final isDownloaded = DownloadService().isDownloaded(progressKey);

        String? episodeTitle;
        if (episodeId != null) {
          episodeTitle = _getEpisodeTitle(item, libraryItem, episodeId);
        }

        final isOnAbsorbing = lib.isOnAbsorbingList(progressKey);
        // Removing an item lives in the edit mode. It used to be a left swipe,
        // which put an un-undoable server change one stray scroll away.
        return SwipeAction(
          key: ValueKey('$libraryItemId-${episodeId ?? ''}'),
          onStartToEnd: isOnAbsorbing
              ? null
              : SwipeActionSpec(
                  icon: Icons.add_circle_outline_rounded,
                  color: cs.primary,
                  onTrigger: () async {
                    await addToAbsorbingWithPicker(context, progressKey,
                        item: libraryItem,
                        addedToast: Wording.of(context).playlistDetailAddedToAbsorbing(episodeTitle ?? title));
                  },
                ),
          child: Padding(
            padding: const EdgeInsets.only(bottom: 8),
            child: Card(
              elevation: 0,
              color: cs.surfaceContainerHigh,
              shape: RoundedRectangleBorder(borderRadius: BorderRadius.circular(14)),
              clipBehavior: Clip.antiAlias,
              child: InkWell(
                onTap: () => _openItem(item, libraryItem, libraryItemId, episodeId),
                borderRadius: BorderRadius.circular(14),
                child: SizedBox(
                  height: 112,
                  child: Row(children: [
                    AspectRatio(
                      aspectRatio: 1,
                      child: Stack(children: [
                        Positioned.fill(
                          child: coverUrl != null
                              ? (coverUrl.startsWith('/')
                                  ? Image.file(File(coverUrl), fit: BoxFit.cover,
                                      errorBuilder: (_, __, ___) => _placeholder(cs))
                                  : CachedNetworkImage(imageRenderMethodForWeb: ImageRenderMethodForWeb.HttpGet, 
                                      imageUrl: coverUrl, fit: BoxFit.cover,
                                      httpHeaders: lib.mediaHeaders,
                                      placeholder: (_, __) => _placeholder(cs),
                                      errorWidget: (_, __, ___) => _placeholder(cs),
                                    ))
                              : _placeholder(cs),
                        ),
                        if (progress > 0 && !isFinished)
                          Positioned(
                            left: 0, right: 0, bottom: 0,
                            child: LinearProgressIndicator(
                              value: progress.clamp(0.0, 1.0),
                              minHeight: 3,
                              backgroundColor: Colors.black38,
                              valueColor: AlwaysStoppedAnimation(cs.primary),
                            ),
                          ),
                        if (isFinished || isDownloaded)
                          Positioned(
                            left: 0, right: 0, bottom: 0,
                            child: CoverStateBadges(isDownloaded: isDownloaded, isFinished: isFinished, isSkimmed: isSkimmed),
                          ),
                      ]),
                    ),
                    Expanded(
                      child: Padding(
                        padding: const EdgeInsets.symmetric(horizontal: 14, vertical: 10),
                        child: Column(
                          crossAxisAlignment: CrossAxisAlignment.start,
                          mainAxisAlignment: MainAxisAlignment.center,
                          children: [
                            Text(episodeTitle ?? title,
                              maxLines: 2, overflow: TextOverflow.ellipsis,
                              style: tt.bodyMedium?.copyWith(fontWeight: FontWeight.w600, color: cs.onSurface)),
                            const SizedBox(height: 4),
                            Text(episodeTitle != null ? title : author,
                              maxLines: 1, overflow: TextOverflow.ellipsis,
                              style: tt.labelSmall?.copyWith(color: cs.onSurfaceVariant)),
                          ],
                        ),
                      ),
                    ),
                  ]),
                ),
              ),
            ),
          ),
        );
      },
    );
  }

  Widget _buildGrid(ColorScheme cs, TextTheme tt, LibraryProvider lib, List<dynamic> items, AppLocalizations l) {
    return GridView.builder(
      controller: widget.scrollController,
      padding: const EdgeInsets.symmetric(horizontal: 16, vertical: 4)
          .copyWith(bottom: 40),
      gridDelegate: SliverGridDelegateWithFixedCrossAxisCount(
        crossAxisCount: coverGridCount(context),
        mainAxisSpacing: 10,
        crossAxisSpacing: 10,
        childAspectRatio: 0.62,
      ),
      itemCount: items.length,
      itemBuilder: (context, index) {
        final item = items[index] as Map<String, dynamic>;
        final libraryItemId = item['libraryItemId'] as String? ?? '';
        final episodeId = item['episodeId'] as String?;
        final libraryItem = item['libraryItem'] as Map<String, dynamic>?;
        if (libraryItem == null) return const SizedBox.shrink();

        final media = libraryItem['media'] as Map<String, dynamic>? ?? {};
        final metadata = media['metadata'] as Map<String, dynamic>? ?? {};
        final title = metadata['title'] as String? ?? l.unknown;
        final author = metadata['authorName'] as String? ?? '';
        final coverUrl = lib.getCoverUrl(libraryItemId);
        final isExplicit = PlayerSettings.showExplicitBadge && metadata['explicit'] == true;
        final progressKey = episodeId != null ? '$libraryItemId-$episodeId' : libraryItemId;
        final progress = lib.getProgress(progressKey);
        final isFinished = lib.getProgressData(progressKey)?['isFinished'] == true;
        final isSkimmed = lib.getProgressData(progressKey)?['skimmed'] == true;
        final isDownloaded = DownloadService().isDownloaded(progressKey);

        String? episodeTitle;
        if (episodeId != null) {
          episodeTitle = _getEpisodeTitle(item, libraryItem, episodeId);
        }

        return GestureDetector(
          onTap: () => _openItem(item, libraryItem, libraryItemId, episodeId),
          child: Column(
            crossAxisAlignment: CrossAxisAlignment.start,
            children: [
              AspectRatio(
                aspectRatio: 1,
                child: ClipRRect(
                  borderRadius: BorderRadius.circular(10),
                  child: Stack(children: [
                    Positioned.fill(
                      child: coverUrl != null
                          ? (coverUrl.startsWith('/')
                              ? Image.file(File(coverUrl), fit: BoxFit.cover,
                                  errorBuilder: (_, __, ___) => _placeholder(cs))
                              : CachedNetworkImage(imageRenderMethodForWeb: ImageRenderMethodForWeb.HttpGet, 
                                  imageUrl: coverUrl, fit: BoxFit.cover,
                                  httpHeaders: lib.mediaHeaders,
                                  placeholder: (_, __) => _placeholder(cs),
                                  errorWidget: (_, __, ___) => _placeholder(cs),
                                ))
                          : _placeholder(cs),
                    ),
                    if (isExplicit)
                      Positioned(
                        top: 4, right: 4,
                        child: Container(
                          padding: const EdgeInsets.symmetric(horizontal: 4, vertical: 1),
                          decoration: BoxDecoration(
                            color: Colors.red.withValues(alpha: 0.85),
                            borderRadius: BorderRadius.circular(4),
                          ),
                          child: Text(l.bookCardExplicitBadge, style: const TextStyle(color: Colors.white, fontSize: 9, fontWeight: FontWeight.w800)),
                        ),
                      ),
                    if (progress > 0 && !isFinished)
                      Positioned(
                        left: 0, right: 0, bottom: 0,
                        child: LinearProgressIndicator(
                          value: progress.clamp(0.0, 1.0),
                          minHeight: 3,
                          backgroundColor: Colors.black38,
                          valueColor: AlwaysStoppedAnimation(cs.primary),
                        ),
                      ),
                    if (isFinished || isDownloaded)
                      Positioned(
                        left: 0, right: 0, bottom: 0,
                        child: CoverStateBadges(isDownloaded: isDownloaded, isFinished: isFinished, isSkimmed: isSkimmed),
                      ),
                  ]),
                ),
              ),
              const SizedBox(height: 6),
              Text(episodeTitle ?? title, maxLines: 2, overflow: TextOverflow.ellipsis,
                  style: tt.labelSmall?.copyWith(fontWeight: FontWeight.w600, color: cs.onSurface)),
              if ((episodeTitle != null ? title : author).isNotEmpty)
                Text(episodeTitle != null ? title : author, maxLines: 1, overflow: TextOverflow.ellipsis,
                    style: tt.labelSmall?.copyWith(fontSize: 10, color: cs.onSurfaceVariant)),
            ],
          ),
        );
      },
    );
  }

  Widget _placeholder(ColorScheme cs) {
    return Container(
      color: cs.surfaceContainerHigh,
      child: Icon(Icons.music_note_rounded, size: 20,
        color: cs.onSurfaceVariant.withValues(alpha: 0.3)),
    );
  }
}