v5.4.0

Bookends 5.4.0

Better compatibility with night-mode patches, twelve more tokens usable in conditionals, and chapter tokens that fall back to whole-book values when chapter info isn't available.

New

• Twelve more tokens are now usable in [if:] conditionals. Previously these rendered correctly via %token but couldn't be tested as bareword conditions or compared numerically:
  • Time tokens: chap_time_left, book_time_left, book_read_time, session_time (all integer minutes, so [if:book_time_left>30] works)
  • Annotation counts: highlights, notes, bookmarks
  • Document metadata: filename, lang, series_name, series_num
  • Frontlight: warmth (devices with natural light only)

Changes

• %chap_pages_left, %chap_read, %chap_pages, %chap_pct, and %chap_time_left now fall back to whole-book values when there's no chapter info available. Previously rendered empty in chapterless books, single-chapter books, and the last chapter of any book. Now matches stock KOReader's status-bar behaviour: treats the whole book as one chapter when the TOC API has nothing to say.
• Improved compatibility with night-mode dim patches (e.g. 2-dim-during-refresh.lua). Bookends used to enter a feedback loop with patches that hook the refresh path, causing the frontlight to pulse and the screen to freeze when both were active. The loop is now closed at multiple layers.
• Reduced subtle nightmode flicker. Bookends used to refresh the entire reader UI every minute regardless of whether anything had changed; now only the overlay area refreshes, and only if a time-sensitive token is actually in use.
• Bottom-center tap gesture can now be reset to "Do nothing". Previously the only way to clear it was the non-discoverable "tap the active radio option to deselect it" interaction.