A cross platform Audiobookshelf client for Android and iOS
Dart
import 'dart:convert';
import 'dart:io';
import 'package:flutter/foundation.dart';
import 'package:flutter/material.dart';
import 'package:provider/provider.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 'package:palette_generator/palette_generator.dart';
import '../utils/cover_accent.dart';
import '../widgets/absorbing_shared.dart';
import '../providers/auth_provider.dart';
import '../providers/library_provider.dart';
import '../services/api_service.dart';
import '../services/audio_player_service.dart';
import '../services/download_service.dart';
import '../services/ebook_cache.dart';
import '../services/narrated_books.dart';
import '../services/narration_service.dart';
import '../widgets/ebook_router.dart';
import '../widgets/cover_badges.dart';
import '../widgets/overlay_toast.dart';
import '../widgets/narration_download_dialog.dart';
import '../widgets/home_section.dart';
import '../widgets/absorb_page_header.dart';
import '../widgets/library_picker_sheet.dart';
import '../widgets/shimmer.dart';
import '../widgets/book_detail_sheet.dart';
import '../widgets/card_buttons.dart';
import '../widgets/episode_list_sheet.dart';
import '../main.dart' show flatNotifier, gradientIntensityNotifier;
import '../widgets/home_customize_sheet.dart';
import '../widgets/playlist_detail_sheet.dart';
import '../widgets/collection_detail_sheet.dart';
import '../widgets/section_detail_sheet.dart';
import '../widgets/feature_hint.dart';
import '../widgets/hover_cover_actions.dart';
import '../widgets/offline_status_icon.dart';
import '../widgets/desktop_batch_actions.dart';
import '../widgets/desktop_cover_size_control.dart';
import '../widgets/scroll_reveal.dart';
import '../widgets/section_labels.dart';
import 'app_shell.dart';
import '../l10n/app_localizations.dart';
import '../utils/desktop_workspace.dart';
import '../utils/duration_format.dart';
import '../utils/app_platform.dart';
import '../utils/media_card_gesture_policy.dart';
class HomeScreen extends StatefulWidget {
const HomeScreen({super.key});
@override
State<HomeScreen> createState() => HomeScreenState();
}
class HomeScreenState extends State<HomeScreen>
with SingleTickerProviderStateMixin {
final _player = AudioPlayerService();
bool _hideEbookOnly = false;
bool _rectangleCovers = false;
int _bookshelfCoverSize = 120;
bool _showSubtitles = false;
bool _cardsOpenDetails = false;
bool _selectionMode = false;
bool _batchActionBusy = false;
String? _bookMatchProgress;
final Set<String> _selectedItemIds = {};
double get _desktopShelfScale => 1.2 * (_bookshelfCoverSize / 120);
void _resetSelectionState() {
_selectionMode = false;
_batchActionBusy = false;
_selectedItemIds.clear();
}
void _clearSelection() {
if (!_selectionMode && _selectedItemIds.isEmpty) return;
setState(_resetSelectionState);
}
void _toggleSelection(Map<String, dynamic> item) {
final itemId = item['id'] as String?;
if (itemId == null) return;
setState(() {
_selectionMode = true;
if (!_selectedItemIds.add(itemId)) _selectedItemIds.remove(itemId);
});
}
Map<String, dynamic>? _selectableHomeItem(
dynamic entity, {
required String sectionType,
}) {
if (sectionType == 'author' ||
sectionType == 'authors' ||
sectionType == 'series' ||
sectionType == 'episode') {
return null;
}
if (entity is! Map<String, dynamic>) return null;
var item = entity;
if (sectionType == 'playlist') {
if (entity['episodeId'] != null) return null;
final nested = entity['libraryItem'];
if (nested is! Map<String, dynamic>) return null;
item = nested;
}
if (item['recentEpisode'] != null || item['id'] is! String) return null;
return item;
}
List<Map<String, dynamic>> _selectableHomeItems() {
final byId = <String, Map<String, dynamic>>{};
for (final item in _cachedClItems ?? const <dynamic>[]) {
final selectable = _selectableHomeItem(item, sectionType: 'book');
final id = selectable?['id'] as String?;
if (id != null) byId[id] = selectable!;
}
for (final section in _cachedSections ?? const <Map<String, dynamic>>[]) {
final id = section['id'] as String? ?? '';
if (id == 'continue-listening') continue;
final type = id.startsWith('playlist:')
? 'playlist'
: id.startsWith('collection:')
? 'collection'
: (section['type'] as String? ?? 'book');
final entities = _filterEbookOnly(
section['entities'] as List<dynamic>? ?? const [],
sectionType: section['type'] as String?,
);
for (final entity in entities) {
final selectable = _selectableHomeItem(entity, sectionType: type);
final itemId = selectable?['id'] as String?;
if (itemId != null) byId[itemId] = selectable!;
}
}
return byId.values.toList();
}
void _toggleSelectAll() {
final ids = _selectableHomeItems()
.map((item) => item['id'] as String)
.toSet();
setState(() {
_selectionMode = true;
if (ids.isNotEmpty && _selectedItemIds.containsAll(ids)) {
_selectedItemIds.removeAll(ids);
} else {
_selectedItemIds.addAll(ids);
}
});
}
Future<void> _runBatchAction(Future<bool?> Function() action) async {
if (_batchActionBusy) return;
final visibleIds = _selectableHomeItems()
.map((item) => item['id'] as String)
.toSet();
setState(() {
_selectedItemIds.retainAll(visibleIds);
if (_selectedItemIds.isEmpty) {
_resetSelectionState();
} else {
_batchActionBusy = true;
}
});
if (_selectedItemIds.isEmpty) return;
final success = await action();
if (!mounted) return;
setState(() {
_batchActionBusy = false;
if (success == true) _resetSelectionState();
});
}
void _changeBookshelfCoverSize(int direction) {
final sizes = PlayerSettings.bookshelfCoverSizes;
final currentIndex = sizes.indexOf(_bookshelfCoverSize);
final nextIndex = (currentIndex + direction).clamp(0, sizes.length - 1);
final next = sizes[nextIndex];
if (next == _bookshelfCoverSize) return;
setState(() => _bookshelfCoverSize = next);
PlayerSettings.setBookshelfCoverSize(next);
}
// ── Scroll-to-hide bars ──
/// Continuous 0..1 reveal value the AppShell mirrors onto the bottom nav.
late final ScrollRevealDriver _revealDriver = ScrollRevealDriver(vsync: this);
ValueListenable<double> get barsRevealNotifier => _revealDriver.notifier;
void resetReveal() => _revealDriver.resetToShown();
final _scrollController = ScrollController();
// Cached filtered sections — invalidated when source data or settings change.
List<Map<String, dynamic>>? _cachedSections;
List<dynamic>? _cachedClItems;
List<dynamic>? _lastSectionsRef;
List<dynamic>? _lastPlaylistsRef;
List<dynamic>? _lastCollectionsRef;
List<String>? _lastSectionOrder;
Set<String>? _lastHiddenIds;
bool _lastHideEbook = false;
bool _lastIsPodcast = false;
// Track player state to know when to re-fetch personalized sections.
String? _lastKnownItemId;
bool _lastKnownPlaying = false;
@override
void initState() {
super.initState();
_revealDriver.attach(_scrollController);
_player.addListener(_onPlayerChanged);
PlayerSettings.settingsChanged.addListener(_loadSettings);
_loadSettings();
Future.microtask(() {
final lib = context.read<LibraryProvider>();
if (lib.libraries.isEmpty) lib.loadLibraries();
lib.refreshLocalProgress();
});
// Tell AppShell we're alive so its bottom-nav listener can attach now
// rather than waiting on a postFrame retry that may never re-fire.
WidgetsBinding.instance.addPostFrameCallback((_) {
if (mounted) AppShell.notifyScreenReady(0);
});
}
// Which library the cover shape was resolved for; re-resolved when the
// selected library changes (see build) or settings change.
String? _coversLibraryId;
Future<void> _loadSettings() async {
final libId = mounted
? context.read<LibraryProvider>().selectedLibraryId
: null;
_coversLibraryId = libId;
final results = await Future.wait([
PlayerSettings.getHideEbookOnly(),
PlayerSettings.getRectangleCoversFor(libId),
PlayerSettings.getBookshelfCoverSize(),
PlayerSettings.getShowSubtitlesFor(libId),
PlayerSettings.getHomeCardsOpenDetails(),
]);
if (mounted)
setState(() {
_hideEbookOnly = results[0] as bool;
_rectangleCovers = results[1] as bool;
_bookshelfCoverSize = results[2] as int;
_showSubtitles = results[3] as bool;
_cardsOpenDetails = results[4] as bool;
});
}
@override
void didChangeDependencies() {
super.didChangeDependencies();
// Refresh setting when returning to screen, but only if changed
PlayerSettings.getHideEbookOnly().then((v) {
if (mounted && v != _hideEbookOnly) setState(() => _hideEbookOnly = v);
});
}
List<dynamic> _filterEbookOnly(List<dynamic> items, {String? sectionType}) {
if (!_hideEbookOnly) return items;
// Only book shelves can contain ebook-only entries. Series/author/
// episode/playlist/collection shelves hold aggregate objects that have
// no audio metadata and would all be incorrectly filtered out.
if (sectionType != null && sectionType != 'book') return items;
return items.where((e) {
if (e is! Map<String, dynamic>) return true;
// Personalized view entities may nest the item under 'libraryItem'
final item = e.containsKey('libraryItem')
? e['libraryItem'] as Map<String, dynamic>? ?? e
: e;
return !PlayerSettings.isEbookOnly(item);
}).toList();
}
/// Recompute cached filtered sections only when input data changes.
void _refreshFilteredCache(LibraryProvider lib) {
final sections = lib.personalizedSections;
final playlists = lib.playlists;
final collections = lib.collections;
final isPod = lib.isPodcastLibrary;
final sectionOrder = lib.sectionOrder;
final hiddenIds = lib.hiddenSectionIds;
if (identical(sections, _lastSectionsRef) &&
identical(playlists, _lastPlaylistsRef) &&
identical(collections, _lastCollectionsRef) &&
identical(sectionOrder, _lastSectionOrder) &&
identical(hiddenIds, _lastHiddenIds) &&
_hideEbookOnly == _lastHideEbook &&
isPod == _lastIsPodcast &&
_cachedSections != null) {
return; // cache is still valid
}
_lastSectionsRef = sections;
_lastPlaylistsRef = playlists;
_lastCollectionsRef = collections;
_lastSectionOrder = sectionOrder;
_lastHiddenIds = hiddenIds;
_lastHideEbook = _hideEbookOnly;
_lastIsPodcast = isPod;
// Continue-listening items
List<dynamic> clItems = [];
for (final section in sections) {
if (section['id'] == 'continue-listening') {
clItems = _filterEbookOnly(
(section['entities'] as List<dynamic>?) ?? [],
sectionType: section['type'] as String?,
);
break;
}
}
if (isPod && clItems.isNotEmpty) {
final seen = <String>{};
clItems = clItems.where((item) {
final id = (item as Map<String, dynamic>)['id'] as String? ?? '';
return seen.add(id);
}).toList();
}
_cachedClItems = clItems;
_cachedSections = lib.getOrderedHomeSections();
}
@override
void dispose() {
_revealDriver.dispose();
_scrollController.dispose();
_player.removeListener(_onPlayerChanged);
PlayerSettings.settingsChanged.removeListener(_loadSettings);
super.dispose();
}
void _onPlayerChanged() {
if (!mounted) return;
final lib = context.read<LibraryProvider>();
lib.refreshLocalProgress();
// Refresh only progress-driven shelves when the playing item changes or
// playback stops. Keep Discover stable unless there is a full refresh.
final currentId = _player.currentItemId;
final playing = _player.isPlaying;
final itemChanged = currentId != _lastKnownItemId;
final stopped = _lastKnownPlaying && !playing;
_lastKnownItemId = currentId;
_lastKnownPlaying = playing;
if (itemChanged || stopped) {
lib.refreshProgressShelves(
force: stopped,
reason: stopped ? 'player-stopped' : 'player-item-changed',
);
}
if (itemChanged || stopped) {
setState(() {});
}
}
/// A heading that opens the whole shelf, over a row of big cover cards.
/// Reading cards open the reader instead of playing.
List<Widget> _heroShelf({
required LibraryProvider lib,
required String title,
required IconData icon,
required List<dynamic> items,
required bool reading,
required bool selectionAvailable,
}) {
if (items.isEmpty) return const <Widget>[];
final cs = Theme.of(context).colorScheme;
final tt = Theme.of(context).textTheme;
final desktop = isDesktopWorkspace(context);
final desktopCardWidth = 180 * (_bookshelfCoverSize / 120);
Widget card(Map<String, dynamic> item) => RepaintBoundary(
child: _ContinueListeningCard(
item: item,
lib: lib,
player: _player,
rectangleCovers: _rectangleCovers,
desktopWidth: desktop ? desktopCardWidth : 180,
reading: reading,
tapOpensDetails: _cardsOpenDetails,
selectionMode: selectionAvailable && _selectionMode,
selected: _selectedItemIds.contains(item['id'] as String?),
onSelectionToggle:
selectionAvailable &&
item['recentEpisode'] == null &&
item['id'] is String
? () => _toggleSelection(item)
: null,
),
);
return <Widget>[
SliverToBoxAdapter(
child: GestureDetector(
onTap: _selectionMode
? null
: () => SectionDetailSheet.show(
context,
title: title,
icon: icon,
entities: items,
coverAspectRatio: _rectangleCovers ? 2 / 3 : 1.0,
),
behavior: HitTestBehavior.opaque,
child: Padding(
padding: const EdgeInsets.fromLTRB(20, 24, 20, 0),
child: Row(
children: [
Icon(icon, size: 16, color: cs.primary.withValues(alpha: 0.7)),
const SizedBox(width: 8),
Text(
title,
style: tt.titleSmall?.copyWith(
fontWeight: FontWeight.w500,
color: cs.onSurface.withValues(alpha: 0.8),
letterSpacing: 0.3,
),
),
const SizedBox(width: 4),
Icon(
Icons.chevron_right_rounded,
size: 16,
color: cs.onSurfaceVariant.withValues(alpha: 0.4),
),
const SizedBox(width: 12),
Expanded(
child: Container(
height: 0.5,
color: cs.outlineVariant.withValues(alpha: 0.2),
),
),
],
),
),
),
),
if (!reading && !_cardsOpenDetails && !desktop && !AppPlatform.lacksPhonePlugins)
const SliverToBoxAdapter(
child: FeatureHint(
prefKey: 'hint_continue_listening_gestures',
message: 'Tap a card to resume. Press and hold to see details.',
),
),
SliverToBoxAdapter(
child: Padding(
padding: const EdgeInsets.only(top: 12),
child: SizedBox(
// Taller row when 2:3 covers are on; the card's
// cover alone is ~225 with rectangle covers.
height:
(_rectangleCovers ? 320 : 250) *
(desktop ? _desktopShelfScale : 1.0),
child: desktop
? SnapScrollList(
cardWidth: desktopCardWidth,
desktop: true,
itemCount: items.length,
itemBuilder: (context, i) =>
card(items[i] as Map<String, dynamic>),
)
: ListView.separated(
scrollDirection: Axis.horizontal,
padding: const EdgeInsets.symmetric(horizontal: 20),
physics: const BouncingScrollPhysics(),
itemCount: items.length,
separatorBuilder: (_, __) => const SizedBox(width: 10),
itemBuilder: (context, i) =>
card(items[i] as Map<String, dynamic>),
),
),
),
),
];
}
static const _sectionIcons = {
'continue-listening': Icons.play_circle_outline_rounded,
'continue-reading': Icons.menu_book_rounded,
'continue-series': Icons.auto_stories_rounded,
'recently-added': Icons.new_releases_outlined,
'listen-again': Icons.replay_rounded,
'discover': Icons.explore_outlined,
'episodes-recently-added': Icons.podcasts_rounded,
'downloaded-books': Icons.download_done_rounded,
};
Widget _refreshWrapper({
required bool desktop,
required LibraryProvider lib,
required Widget child,
}) {
if (desktop) return child;
return RefreshIndicator(
onRefresh: () async {
await lib.refresh();
},
child: child,
);
}
@override
Widget build(BuildContext context) {
final cs = Theme.of(context).colorScheme;
final tt = Theme.of(context).textTheme;
final l = AppLocalizations.of(context)!;
final desktop = isDesktopWorkspace(context);
_revealDriver.setEnabled(!desktop);
final scaffoldBg = Theme.of(context).scaffoldBackgroundColor;
final lowerFade = Color.lerp(cs.surface, scaffoldBg, 0.55) ?? scaffoldBg;
final lib = context.watch<LibraryProvider>();
final auth = context.watch<AuthProvider>();
final selectionAvailable = desktop && !lib.isOffline;
if (!selectionAvailable && _selectionMode) _resetSelectionState();
final allLibraries = lib.libraries;
final libraryName =
lib.selectedLibrary?['name'] as String? ?? l.libraryFallback;
// Cover shape can differ per library; re-resolve after a library switch.
if (lib.selectedLibraryId != _coversLibraryId) {
_coversLibraryId = lib.selectedLibraryId;
_resetSelectionState();
PlayerSettings.getRectangleCoversFor(_coversLibraryId).then((v) {
if (mounted && v != _rectangleCovers)
setState(() => _rectangleCovers = v);
});
PlayerSettings.getShowSubtitlesFor(_coversLibraryId).then((v) {
if (mounted && v != _showSubtitles) setState(() => _showSubtitles = v);
});
}
if (lib.isLoading) {
// Reset cache so stale data isn't shown after a user switch
// (where the new user may have the same number of sections).
_cachedSections = null;
_cachedClItems = null;
_lastSectionsRef = null;
} else {
_refreshFilteredCache(lib);
}
final selectableHomeItems = selectionAvailable
? _selectableHomeItems()
: const <Map<String, dynamic>>[];
if (_selectionMode) {
_selectedItemIds.retainAll(
selectableHomeItems.map((item) => item['id'] as String).toSet(),
);
}
return Scaffold(
backgroundColor: scaffoldBg,
body: Container(
decoration: flatNotifier.value
? null
: BoxDecoration(
gradient: LinearGradient(
begin: Alignment.topCenter,
end: Alignment.bottomCenter,
stops: const [0.0, 0.22, 0.72, 1.0],
colors: [
cs.primary.withValues(
alpha: gradientIntensityNotifier.value,
),
cs.surface,
lowerFade,
scaffoldBg,
],
),
),
child: SafeArea(
child: NotificationListener<ScrollNotification>(
onNotification: (n) {
if (n is ScrollEndNotification) _revealDriver.settle();
return false;
},
child: _refreshWrapper(
desktop: desktop,
lib: lib,
child: CustomScrollView(
controller: _scrollController,
slivers: [
// ── Top bar: ABSORB title + page name ──
SliverToBoxAdapter(
child: AbsorbPageHeader(
title: l.homeTitle,
showBranding: !desktop,
trailing: OfflineStatusIcon(
onTapWhenOnline: () {
lib.setManualOffline(true);
final dl = DownloadService();
final player = AudioPlayerService();
final itemId = player.currentItemId;
final epId = player.currentEpisodeId;
final dlKey = epId != null && itemId != null
? '$itemId-$epId'
: itemId;
if (dlKey == null || !dl.isDownloaded(dlKey)) {
player.stop();
}
},
),
actions: [
if (allLibraries.length > 1)
Material(
color: cs.onSurface.withValues(alpha: 0.06),
borderRadius: BorderRadius.circular(20),
clipBehavior: Clip.antiAlias,
child: InkWell(
onTap: () => showLibraryPickerSheet(context, lib),
borderRadius: BorderRadius.circular(20),
child: Container(
padding: const EdgeInsets.symmetric(
horizontal: 10,
vertical: 5,
),
decoration: BoxDecoration(
borderRadius: BorderRadius.circular(20),
border: Border.all(
color: cs.onSurface.withValues(alpha: 0.08),
),
),
child: SizedBox(
height: 20,
child: Row(
mainAxisSize: MainAxisSize.min,
children: [
Icon(
lib.isPodcastLibrary
? Icons.podcasts_rounded
: Icons.auto_stories_rounded,
size: 18,
color: cs.onSurfaceVariant,
),
const SizedBox(width: 6),
ConstrainedBox(
constraints: const BoxConstraints(
maxWidth: 140,
),
child: Text(
libraryName,
style: TextStyle(
fontSize: 13,
fontWeight: FontWeight.w600,
color: cs.onSurfaceVariant,
),
overflow: TextOverflow.ellipsis,
maxLines: 1,
),
),
const SizedBox(width: 4),
Icon(
Icons.unfold_more_rounded,
size: 18,
color: cs.onSurfaceVariant,
),
],
),
),
),
),
),
if (desktop && !lib.isOffline)
Tooltip(
message: l.refreshTooltip,
child: GestureDetector(
onTap: () {
_clearSelection();
lib.refresh();
},
child: Container(
padding: const EdgeInsets.symmetric(
horizontal: 8,
vertical: 5,
),
decoration: BoxDecoration(
color: cs.onSurface.withValues(alpha: 0.06),
borderRadius: BorderRadius.circular(20),
border: Border.all(
color: cs.onSurface.withValues(alpha: 0.08),
),
),
child: SizedBox(
height: 20,
child: Icon(
Icons.refresh_rounded,
size: 18,
color: cs.onSurfaceVariant,
),
),
),
),
),
if (desktop && !lib.isOffline)
Tooltip(
message: _selectionMode
? l.downloadsCancelSelection
: 'Select items',
child: IconButton(
onPressed: _selectionMode
? _clearSelection
: () => setState(() => _selectionMode = true),
icon: Icon(
_selectionMode
? Icons.close_rounded
: Icons.library_add_check_rounded,
),
),
),
if (!lib.isOffline)
GestureDetector(
onTap: () => HomeCustomizeSheet.show(context),
child: Container(
padding: const EdgeInsets.symmetric(
horizontal: 8,
vertical: 5,
),
decoration: BoxDecoration(
color: cs.onSurface.withValues(alpha: 0.06),
borderRadius: BorderRadius.circular(20),
border: Border.all(
color: cs.onSurface.withValues(alpha: 0.08),
),
),
child: SizedBox(
height: 20,
child: Icon(
Icons.tune_rounded,
size: 18,
color: cs.onSurfaceVariant,
),
),
),
),
],
),
),
// (Continue Listening is now rendered in the generic sections loop below)
// ── Loading shimmer ──
if (lib.isLoading) ...[
const SliverToBoxAdapter(child: SizedBox(height: 16)),
const SliverToBoxAdapter(child: ShimmerHeroCard()),
const SliverToBoxAdapter(child: SizedBox(height: 20)),
const SliverToBoxAdapter(child: ShimmerBookRow()),
const SliverToBoxAdapter(child: SizedBox(height: 8)),
const SliverToBoxAdapter(child: ShimmerBookRow()),
],
// ── Error ──
if (!lib.isLoading &&
lib.errorMessage != null &&
lib.personalizedSections.isEmpty)
SliverFillRemaining(
child: Center(
child: Column(
mainAxisSize: MainAxisSize.min,
children: [
Icon(
Icons.cloud_off_rounded,
size: 48,
color: cs.error,
),
const SizedBox(height: 12),
Text(
lib.errorMessage!,
style: tt.bodyLarge?.copyWith(color: cs.error),
),
const SizedBox(height: 16),
FilledButton.tonal(
onPressed: lib.refresh,
child: Text(l.retry),
),
],
),
),
),
// ── Empty ──
if (!lib.isLoading &&
lib.errorMessage == null &&
lib.personalizedSections.isEmpty &&
(lib.libraries.isNotEmpty || lib.isOffline))
SliverFillRemaining(
child: Center(
child: Column(
mainAxisSize: MainAxisSize.min,
children: [
Icon(
lib.isOffline
? Icons.download_for_offline_outlined
: Icons.library_music_outlined,
size: 48,
color: cs.onSurfaceVariant,
),
const SizedBox(height: 12),
Text(
lib.isOffline
? l.noDownloadedBooks
: l.yourLibraryIsEmpty,
style: tt.bodyLarge?.copyWith(
color: cs.onSurfaceVariant,
),
),
if (lib.isOffline) ...[
const SizedBox(height: 4),
Text(
l.downloadBooksWhileOnline,
style: tt.bodySmall?.copyWith(
color: cs.onSurfaceVariant.withValues(
alpha: 0.6,
),
),
),
],
],
),
),
),
// ── All sections (including Continue Listening) ──
if (!lib.isLoading)
...(_cachedSections ?? []).expand((section) {
final id = section['id'] as String? ?? '';
final isPlaylist = id.startsWith('playlist:');
final isCollection = id.startsWith('collection:');
// Playlists/collections are server-only; hide when offline
if ((isPlaylist || isCollection) && lib.isOffline)
return <Widget>[];
// Continue Listening and Continue Reading get the big
// cover cards.
if (id == 'continue-listening') {
return _heroShelf(
lib: lib,
title: l.continueListening,
icon: Icons.play_circle_outline_rounded,
items: _cachedClItems ?? const [],
reading: false,
selectionAvailable: selectionAvailable,
);
}
if (id == 'continue-reading') {
return _heroShelf(
lib: lib,
title: sectionLabel(
id,
section['label'] as String?,
l,
),
icon: Icons.menu_book_rounded,
items: _filterEbookOnly(
(section['entities'] as List<dynamic>?) ?? [],
sectionType: section['type'] as String?,
),
reading: true,
selectionAvailable: selectionAvailable,
);
}
final label = sectionLabel(
id,
section['label'] as String?,
l,
);
final entities = _filterEbookOnly(
(section['entities'] as List<dynamic>?) ?? [],
sectionType: section['type'] as String?,
);
final type = isPlaylist
? 'playlist'
: isCollection
? 'collection'
: (section['type'] ?? 'book');
if (entities.isEmpty) return <Widget>[];
VoidCallback? titleTap;
IconData sectionIcon;
if (isPlaylist) {
titleTap = () => PlaylistDetailSheet.show(
context,
section['_playlistId'] as String,
);
sectionIcon = Icons.playlist_play_rounded;
} else if (isCollection) {
titleTap = () => CollectionDetailSheet.show(
context,
section['_collectionId'] as String,
);
sectionIcon = section['_smartScope'] == true
? Icons.filter_alt_rounded
: Icons.collections_bookmark_rounded;
} else if (id.startsWith('genre:')) {
sectionIcon = Icons.label_outline_rounded;
final sectionLabel = label;
titleTap = () => SectionDetailSheet.show(
context,
title: sectionLabel,
icon: sectionIcon,
entities: entities,
coverAspectRatio: _rectangleCovers ? 2 / 3 : 1.0,
);
} else {
sectionIcon = _sectionIcons[id] ?? Icons.album_outlined;
// Author/series sections don't have book-shaped entities,
// so skip the book-oriented SectionDetailSheet for them.
if (type != 'authors' && type != 'series') {
final sectionLabel = label;
titleTap = () => SectionDetailSheet.show(
context,
title: sectionLabel,
icon: sectionIcon,
entities: entities,
coverAspectRatio: _rectangleCovers ? 2 / 3 : 1.0,
);
}
}
return <Widget>[
SliverToBoxAdapter(
child: HomeSection(
title: label,
icon: sectionIcon,
entities: entities,
sectionType: type,
sectionId: id,
onTitleTap: _selectionMode ? null : titleTap,
coverAspectRatio: _rectangleCovers ? 2 / 3 : 1.0,
desktopScale: _desktopShelfScale,
showSubtitles: _showSubtitles,
selectionMode: selectionAvailable && _selectionMode,
selectedItemIds: _selectedItemIds,
onSelectionToggle: selectionAvailable
? _toggleSelection
: null,
),
),
];
}),
SliverPadding(
padding: EdgeInsets.only(bottom: desktop ? 80 : 100),
),
],
),
),
),
),
),
floatingActionButton: !desktop
? null
: _selectionMode
? DesktopBatchActionBar(
selectedCount: _selectedItemIds.length,
selectableCount: selectableHomeItems.length,
busy: _batchActionBusy,
busyLabel: _bookMatchProgress,
canQuickMatch:
!lib.isPodcastLibrary &&
!lib.isOffline &&
(auth.isAdmin ||
(auth.isBookOrbit &&
auth.canUpdateMetadata &&
lib.selectedLibraryId != ApiService.bookDockLibraryId)),
canMarkProgress: !lib.isPodcastLibrary,
canDelete: auth.canDelete && !lib.isOffline,
canDownload: !AppPlatform.lacksPhonePlugins && !lib.isPodcastLibrary,
onSelectAll: _toggleSelectAll,
onClear: _clearSelection,
onDownload: () => _runBatchAction(
() => DesktopBatchActions.download(
context,
selectableHomeItems
.where((i) => _selectedItemIds.contains(i['id']))
.toList(),
),
),
onQuickMatch: () => _runBatchAction(() async {
final ok = await DesktopBatchActions.quickMatch(
context,
_selectedItemIds.toList(),
onProgress: (done, total) {
if (mounted) setState(() => _bookMatchProgress = '$done/$total');
},
);
if (mounted) setState(() => _bookMatchProgress = null);
return ok;
}),
onMarkFinished: () => _runBatchAction(
() => DesktopBatchActions.setFinished(
context,
_selectedItemIds.toList(),
isFinished: true,
),
),
onMarkUnfinished: () => _runBatchAction(
() => DesktopBatchActions.setFinished(
context,
_selectedItemIds.toList(),
isFinished: false,
),
),
onDelete: () => _runBatchAction(
() => DesktopBatchActions.delete(
context,
_selectedItemIds.toList(),
),
),
)
: DesktopCoverSizeControl(
value: _bookshelfCoverSize,
onDecrease: () => _changeBookshelfCoverSize(-1),
onIncrease: () => _changeBookshelfCoverSize(1),
),
floatingActionButtonLocation: FloatingActionButtonLocation.endFloat,
);
}
}
// Process-wide cache of cover-derived accent colors. Same cover URL never
// runs PaletteGenerator twice in a session - extraction is image-decode +
// k-means clustering, far too expensive to repeat as tiles scroll past.
final Map<String, Color> _accentCache = {};
// ══════════════════════════════════════════════════════════════
// Continue Listening Card — compact card with play button
// ══════════════════════════════════════════════════════════════
class _ContinueListeningCard extends StatefulWidget {
final Map<String, dynamic> item;
final LibraryProvider lib;
final AudioPlayerService player;
final bool rectangleCovers;
final double desktopWidth;
// A Continue Reading card: reading progress, and opens the reader.
final bool reading;
final bool tapOpensDetails;
final bool selectionMode;
final bool selected;
final VoidCallback? onSelectionToggle;
const _ContinueListeningCard({
required this.item,
required this.lib,
required this.player,
required this.rectangleCovers,
this.desktopWidth = 180,
this.reading = false,
this.tapOpensDetails = false,
this.selectionMode = false,
this.selected = false,
this.onSelectionToggle,
});
@override
State<_ContinueListeningCard> createState() => _ContinueListeningCardState();
}
class _ContinueListeningCardState extends State<_ContinueListeningCard> {
bool _isLoading = false;
Color? _accent;
String? _derivedCoverKey;
static String _fmtRemaining(double s) {
if (s <= 0) return '';
if (s < 60) return '<1m left';
return '${formatHm(s)} left';
}
Widget _buildCoverImage(
String? coverUrl,
ColorScheme cs,
Map<String, String> headers,
) {
final fallback = Container(
color: cs.surfaceContainerHighest,
child: Icon(
widget.reading ? Icons.menu_book_rounded : Icons.headphones_rounded,
size: 32,
color: cs.onSurfaceVariant,
),
);
if (coverUrl == null) return fallback;
final isLocal = coverUrl.startsWith('/');
Widget image({required BoxFit fit}) {
if (isLocal) {
return Image.file(
File(coverUrl),
fit: fit,
errorBuilder: (_, __, ___) => fallback,
);
}
return CachedNetworkImage(imageRenderMethodForWeb: ImageRenderMethodForWeb.HttpGet,
imageUrl: coverUrl,
fit: fit,
httpHeaders: headers,
fadeInDuration: Duration.zero,
fadeOutDuration: Duration.zero,
placeholder: (_, __) => fallback,
errorWidget: (_, __, ___) => fallback,
);
}
// Rectangle mode: tile aspect (2:3) matches most book covers, so fill it.
if (widget.rectangleCovers) return image(fit: BoxFit.cover);
// Square mode: tile is 1:1. Most audiobook covers are square and fill it,
// but rectangular covers would letterbox - fill the gaps with a blurred
// copy of the cover (matches the absorbing card aesthetic). Both image()
// calls share the same cached bytes by URL.
return BlurPaddedCover(
blurChild: image(fit: BoxFit.cover),
child: image(fit: BoxFit.contain),
);
}
/// Pull a vivid accent color from the cover. Uses PaletteGenerator instead
/// of ColorScheme.fromImageProvider because Material 3's harmonized palette
/// flattens vibrant covers into muted tones (a yellow/black cover ends up
/// looking olive-green). The vibrant/dominant swatch keeps the original
/// hue intact. Results are memoized in `_accentCache` so the same cover
/// never runs the extraction twice in a session.
void _deriveScheme(String? coverUrl) {
final key = coverUrl;
if (key == _derivedCoverKey) return;
_derivedCoverKey = key;
if (coverUrl == null) {
if (_accent != null) setState(() => _accent = null);
return;
}
final cached = _accentCache[coverUrl];
if (cached != null) {
_accent = cached;
return;
}
final ImageProvider provider;
if (coverUrl.startsWith('/')) {
provider = FileImage(File(coverUrl));
} else {
provider = CachedNetworkImageProvider(imageRenderMethodForWeb: ImageRenderMethodForWeb.HttpGet,
coverUrl,
headers: widget.lib.mediaHeaders,
);
}
PaletteGenerator.fromImageProvider(provider, maximumColorCount: 16)
.then((palette) {
final picked = accentFromCoverPalette(palette);
if (picked == null) return;
_accentCache[coverUrl] = picked;
if (!mounted) return;
WidgetsBinding.instance.addPostFrameCallback((_) {
if (mounted) setState(() => _accent = picked);
});
})
.catchError((_) {});
}
@override
Widget build(BuildContext context) {
final cs = Theme.of(context).colorScheme;
final tt = Theme.of(context).textTheme;
final l = AppLocalizations.of(context)!;
final gesturePolicy = MediaCardGesturePolicy(isWeb: AppPlatform.lacksPhonePlugins);
final item = widget.item;
final lib = widget.lib;
final player = widget.player;
final itemId = item['id'] as String? ?? '';
final media = item['media'] as Map<String, dynamic>? ?? {};
final metadata = media['metadata'] as Map<String, dynamic>? ?? {};
final recentEpisode = item['recentEpisode'] as Map<String, dynamic>?;
final title = recentEpisode != null
? (recentEpisode['title'] as String? ?? l.homeScreenEpisodeFallback)
: (metadata['title'] as String? ?? l.unknown);
final author = recentEpisode != null
? (metadata['title'] as String? ?? '')
: (metadata['authorName'] as String? ?? '');
final coverUrl = lib.getCoverUrl(itemId);
_deriveScheme(coverUrl);
final episodeId = recentEpisode?['id'] as String?;
final progress = episodeId != null
? lib.getEpisodeProgress(itemId, episodeId)
: lib.getProgress(itemId);
final progressData = episodeId != null
? lib.getEpisodeProgressData(itemId, episodeId)
: lib.getProgressData(itemId);
final isCurrentItem = !widget.reading && player.currentItemId == itemId;
final serverCurrentTime =
(progressData?['currentTime'] as num?)?.toDouble() ?? 0;
double currentTime;
double totalDuration;
if (isCurrentItem && player.hasBook) {
currentTime = player.position.inMilliseconds / 1000.0;
totalDuration = player.totalDuration;
} else {
currentTime = (progressData?['currentTime'] as num?)?.toDouble() ?? 0;
totalDuration =
(progressData?['duration'] as num?)?.toDouble() ??
(recentEpisode != null
? (recentEpisode['duration'] as num?)?.toDouble() ?? 0
: (media['duration'] as num?)?.toDouble() ?? 0);
// Offline there is no server record, only what this phone saved.
if (progressData == null && progress > 0) {
currentTime = progress * totalDuration;
}
}
final accent = _accent ?? cs.primary;
// Force the cover's hue/sat into a theme-appropriate lightness so each
// card reads as its own tint rather than near-identical dark gray. Two
// shades are used as gradient stops to add depth.
final isDark = Theme.of(context).brightness == Brightness.dark;
final HSLColor? bgHsl = _accent == null
? null
: HSLColor.fromColor(accent).withSaturation(
(HSLColor.fromColor(accent).saturation * (isDark ? 0.85 : 0.55))
.clamp(0.0, 1.0),
);
final Color cardBgTop = bgHsl != null
? bgHsl.withLightness(isDark ? 0.19 : 0.95).toColor()
: (isCurrentItem
? cs.primary.withValues(alpha: 0.08)
: cs.surfaceContainerHigh);
final Color cardBgBottom = bgHsl != null
? bgHsl.withLightness(isDark ? 0.11 : 0.88).toColor()
: cardBgTop;
// The percent and progress bar sit on the tinted card bottom; a dark
// cover accent on its own dark tint is invisible (and the reverse in
// light mode). Keep the hue but force lightness contrast with the card.
final Color rowAccent = bgHsl != null
? HSLColor.fromColor(accent)
.withLightness(isDark ? 0.72 : 0.30)
.withSaturation(
HSLColor.fromColor(accent).saturation.clamp(0.35, 1.0),
)
.toColor()
: accent;
// BookOrbit carries an ebook-only book's reading percent as its plain
// progress, with no ebook field.
final readSaved = widget.reading ? lib.getEbookProgress(itemId) : 0.0;
final progressValue = widget.reading
? (readSaved > 0
? readSaved
: (PlayerSettings.isEbookOnly(item) ? progress : 0.0))
.clamp(0.0, 1.0)
: (totalDuration > 0 ? currentTime / totalDuration : progress).clamp(
0.0,
1.0,
);
final remaining = !widget.reading && totalDuration > 0
? totalDuration - currentTime
: 0.0;
void resume() {
if (_isLoading) return;
// Nothing to play: an ebook-only book continues in the reader.
if (recentEpisode == null && (widget.reading || PlayerSettings.isEbookOnly(item))) {
_openEbook(context, itemId, title);
return;
}
if (isCurrentItem) {
if (player.isPlaying) {
player.pause();
} else {
final playerPosSec = player.position.inMilliseconds / 1000.0;
if (serverCurrentTime > playerPosSec + 5.0) {
_startBook(context, itemId);
} else {
player.play(fromUi: true);
}
}
} else {
_startBook(context, itemId);
}
}
void openDetails() {
if (lib.isPodcastLibrary) {
if (recentEpisode != null) {
EpisodeDetailSheet.show(context, item, recentEpisode);
} else {
EpisodeListSheet.show(context, item);
}
} else {
showBookDetailSheet(context, itemId);
}
}
// Long-press opens the quick-actions sheet: book quick sheet for books,
// episode quick sheet for a podcast episode. A bare podcast show falls back
// to opening details.
void openQuickActions() {
if (recentEpisode != null) {
EpisodeDetailSheet.showQuick(context, item, recentEpisode);
} else if (lib.isPodcastLibrary) {
openDetails();
} else {
showQuickActionsSheet(context, itemId, initialItem: item);
}
}
final canEdit =
!lib.isPodcastLibrary &&
!lib.isOffline &&
recentEpisode == null &&
isDesktopWorkspace(context) &&
(context.watch<AuthProvider?>()?.canUpdateMetadata ?? false);
return HoverCoverActions(
onMenu: widget.selectionMode ? null : openQuickActions,
editItemId: canEdit && !widget.selectionMode ? itemId : null,
selectionMode: widget.selectionMode,
selected: widget.selected,
onSelectionToggle: widget.onSelectionToggle,
child: Material(
color: Colors.transparent,
borderRadius: BorderRadius.circular(14),
clipBehavior: Clip.antiAlias,
child: Ink(
decoration: BoxDecoration(
borderRadius: BorderRadius.circular(14),
gradient: LinearGradient(
begin: Alignment.topLeft,
end: Alignment.bottomRight,
colors: [cardBgTop, cardBgBottom],
),
),
child: InkWell(
onTap: widget.selectionMode && widget.onSelectionToggle != null
? widget.onSelectionToggle
: gesturePolicy.continueListeningTapOpensDetails ||
widget.tapOpensDetails
? openDetails
: resume,
onLongPress:
!widget.selectionMode && gesturePolicy.allowsLongPressShortcuts
? openQuickActions
: null,
borderRadius: BorderRadius.circular(14),
child: SizedBox(
width: isDesktopWorkspace(context) ? widget.desktopWidth : 150,
child: Column(
crossAxisAlignment: CrossAxisAlignment.stretch,
children: [
// Floating cover with a colored glow
Padding(
padding: const EdgeInsets.fromLTRB(10, 10, 10, 4),
child: DecoratedBox(
decoration: BoxDecoration(
borderRadius: BorderRadius.circular(10),
boxShadow: [
BoxShadow(
color: accent.withValues(alpha: 0.45),
blurRadius: 14,
spreadRadius: -2,
offset: const Offset(0, 5),
),
],
),
child: ClipRRect(
borderRadius: BorderRadius.circular(10),
child: AspectRatio(
aspectRatio: widget.rectangleCovers ? 2 / 3 : 1,
child: Stack(
children: [
Positioned.fill(
child: _buildCoverImage(
coverUrl,
cs,
lib.mediaHeaders,
),
),
if (DownloadService().isDownloaded(
playbackDownloadKey(itemId, episodeId),
))
const Positioned(
left: 0,
right: 0,
bottom: 0,
child: CoverStateBadges(
isDownloaded: true,
isFinished: false,
),
),
if (isCurrentItem && player.isPlaying)
Positioned(
right: 6,
bottom: 6,
child: Container(
padding: const EdgeInsets.all(5),
decoration: BoxDecoration(
color: Colors.black.withValues(
alpha: 0.55,
),
shape: BoxShape.circle,
),
child: const Icon(
Icons.graphic_eq_rounded,
size: 14,
color: Colors.white,
),
),
),
if (_isLoading)
Positioned.fill(
child: Container(
color: Colors.black.withValues(alpha: 0.4),
child: const Center(
child: SizedBox(
width: 22,
height: 22,
child: CircularProgressIndicator(
strokeWidth: 2,
color: Colors.white,
),
),
),
),
),
],
),
),
),
),
),
// Text + progress area
Expanded(
child: Padding(
padding: const EdgeInsets.fromLTRB(12, 8, 12, 10),
child: Column(
crossAxisAlignment: CrossAxisAlignment.start,
children: [
// Reserve 2 lines of title height so the author row
// stays in a consistent position whether the title
// wraps or not.
SizedBox(
height: 30,
child: Text(
title,
maxLines: 2,
overflow: TextOverflow.ellipsis,
style: tt.bodySmall?.copyWith(
fontWeight: FontWeight.w600,
color: cs.onSurface,
height: 1.2,
),
),
),
if (author.isNotEmpty) ...[
const SizedBox(height: 2),
Text(
author,
maxLines: 1,
overflow: TextOverflow.ellipsis,
style: tt.labelSmall?.copyWith(
color: cs.onSurfaceVariant,
),
),
],
const Spacer(),
ClipRRect(
borderRadius: BorderRadius.circular(2),
child: LinearProgressIndicator(
value: progressValue,
minHeight: 3,
backgroundColor: rowAccent.withValues(
alpha: 0.22,
),
valueColor: AlwaysStoppedAnimation(rowAccent),
),
),
const SizedBox(height: 4),
Row(
children: [
Text(
'${(progressValue * 100).round()}%',
style: tt.labelSmall?.copyWith(
fontWeight: FontWeight.w700,
color: rowAccent,
fontSize: 11,
),
),
if (remaining > 0) ...[
const SizedBox(width: 6),
Expanded(
child: Text(
_fmtRemaining(remaining),
maxLines: 1,
overflow: TextOverflow.ellipsis,
style: tt.labelSmall?.copyWith(
color: cs.onSurfaceVariant,
fontSize: 10,
),
),
),
],
],
),
],
),
),
),
],
),
),
),
),
),
);
}
Future<void> _openEbook(BuildContext context, String itemId, String title) async {
final l = AppLocalizations.of(context)!;
setState(() => _isLoading = true);
var ebookFile = resolveEbookFile(widget.item) ?? await cachedEbookFileFor(itemId);
if (ebookFile == null && context.mounted) {
final api = context.read<AuthProvider>().apiService;
if (api != null) {
try {
ebookFile = resolveEbookFile(await api.getLibraryItem(itemId));
} catch (_) {}
}
}
if (!mounted) return;
setState(() => _isLoading = false);
if (ebookFile == null) {
showOverlayToast(context, l.noEbookFileFound, icon: Icons.menu_book_outlined);
return;
}
await openEbookReader(context, itemId: itemId, title: title, ebookFile: ebookFile);
}
Future<void> _startBook(BuildContext context, String itemId) async {
setState(() => _isLoading = true);
final auth = context.read<AuthProvider>();
final api = auth.apiService;
if (api == null) {
setState(() => _isLoading = false);
return;
}
// Check if this is a podcast with a recentEpisode
final recentEpisode = widget.item['recentEpisode'] as Map<String, dynamic>?;
if (recentEpisode != null) {
// Podcast episode — play the recent episode directly
final l = AppLocalizations.of(context)!;
final episodeId = recentEpisode['id'] as String? ?? '';
final episodeTitle =
recentEpisode['title'] as String? ?? l.homeScreenEpisodeFallback;
final media = widget.item['media'] as Map<String, dynamic>? ?? {};
final metadata = media['metadata'] as Map<String, dynamic>? ?? {};
final showTitle = metadata['title'] as String? ?? '';
final epDuration = (recentEpisode['duration'] as num?)?.toDouble() ?? 0;
final coverUrl = widget.lib.getCoverUrl(itemId);
final error = await widget.player.playItem(
api: api,
itemId: itemId,
title: episodeTitle,
author: showTitle,
coverUrl: coverUrl,
totalDuration: epDuration,
chapters: [],
episodeId: episodeId,
episodeTitle: episodeTitle,
libraryId: widget.item['libraryId'] as String?,
fromUi: true,
);
if (mounted) {
if (error != null) showErrorToast(context, error);
setState(() => _isLoading = false);
}
return;
}
// An Audiobookshelf EPUB that reads itself aloud streams from the server,
// so offline it has to be on the phone already.
if (!auth.isBookOrbit &&
widget.lib.isOffline &&
NarratedBooks.contains(itemId) &&
!NarrationService.instance.hasLocalAudio(itemId)) {
setState(() => _isLoading = false);
if (DownloadService().isDownloading(itemId)) {
showOverlayToast(context, AppLocalizations.of(context)!.narrationDownloadStarted,
icon: Icons.download_rounded);
return;
}
final media = widget.item['media'] as Map<String, dynamic>? ?? {};
final metadata = media['metadata'] as Map<String, dynamic>? ?? {};
await showNarrationDownloadDialog(
context,
itemId: itemId,
title: metadata['title'] as String? ?? '',
author: metadata['authorName'] as String?,
coverUrl: widget.lib.getCoverUrl(itemId),
libraryId: widget.item['libraryId'] as String?,
);
return;
}
final String title;
final String author;
double duration;
List<dynamic> chapters;
String? libraryId;
final downloads = DownloadService();
if (downloads.isDownloaded(itemId)) {
// The download carries everything the player needs, so a book on the
// phone starts without asking the server, offline or not.
final media = widget.item['media'] as Map<String, dynamic>? ?? {};
final metadata = media['metadata'] as Map<String, dynamic>? ?? {};
final info = downloads.getInfo(itemId);
title = metadata['title'] as String? ?? info.title ?? '';
author = metadata['authorName'] as String? ?? info.author ?? '';
duration = (media['duration'] as num?)?.toDouble() ?? 0;
chapters = (media['chapters'] as List<dynamic>?) ?? [];
libraryId = widget.item['libraryId'] as String? ?? info.libraryId;
final cached = downloads.getCachedSessionData(itemId);
if (cached != null && (duration <= 0 || chapters.isEmpty)) {
try {
final session = jsonDecode(cached) as Map<String, dynamic>;
if (duration <= 0) {
duration = (session['duration'] as num?)?.toDouble() ?? 0;
}
if (chapters.isEmpty) {
chapters = session['chapters'] as List<dynamic>? ?? [];
}
} catch (_) {}
}
} else {
final fullItem = await api.getLibraryItem(itemId);
if (fullItem == null) {
if (mounted) {
showErrorToast(context, AppLocalizations.of(context)!.loginCouldNotReachServer);
setState(() => _isLoading = false);
}
return;
}
final media = fullItem['media'] as Map<String, dynamic>? ?? {};
final metadata = media['metadata'] as Map<String, dynamic>? ?? {};
title = metadata['title'] as String? ?? '';
author = metadata['authorName'] as String? ?? '';
duration = (media['duration'] as num?)?.toDouble() ?? 0;
chapters = (media['chapters'] as List<dynamic>?) ?? [];
libraryId = fullItem['libraryId'] as String?;
}
final coverUrl = widget.lib.getCoverUrl(itemId);
// Start playback
final error = await widget.player.playItem(
api: api,
itemId: itemId,
title: title,
author: author,
coverUrl: coverUrl,
totalDuration: duration,
chapters: chapters,
libraryId: libraryId,
fromUi: true,
);
if (error != null && mounted) showErrorToast(context, error);
// Ensure this book is on the absorbing list (clear any manual remove)
if (context.mounted) {
context.read<LibraryProvider>().addToAbsorbing(itemId);
}
if (mounted) setState(() => _isLoading = false);
// Navigate to absorbing screen
if (context.mounted) AppShell.goToAbsorbing(context);
}
}