Skip to content

PPR-25: Books page filters overhaul - #21

Merged
Eoic merged 36 commits into
masterfrom
feature/PPR-25-books-page-filters-overhaul
Aug 1, 2026
Merged

PPR-25: Books page filters overhaul#21
Eoic merged 36 commits into
masterfrom
feature/PPR-25-books-page-filters-overhaul

Conversation

@Eoic

@Eoic Eoic commented Jul 27, 2026

Copy link
Copy Markdown
Member

Ticket

https://trello.com/c/8DcxPUgX

Summary

  • Rebuild library filtering around an immutable LibraryFilters model with composable multi-select metadata, organization, reading, rating, progress, and date filters.
  • Add a draggable advanced-filter bottom sheet with draft previews, active-filter badges, responsive sizing, and root-level modal backdrops.
  • Keep the Books chip row synchronized with advanced filters, sorting, favorites, and small-grid, large-grid, and list display modes.
  • Add matching search, sorting, filtering, and view controls to Shelves.
  • Reuse the Books page for shelf contents while preserving shelf-specific filter state and facet options, plus editable shelf metadata.
  • Remove obsolete query-suggestion, legacy filter-sheet, child-shelf, and duplicate shelf-books implementations.
  • Update the affected provider, model, page, and widget tests for the new APIs and UI behavior.

Testing

  • flutter analyze --no-fatal-infos — no issues found.
  • flutter test --reporter expanded — 973 passed, 9 skipped, 0 failed.
  • git diff --check — clean.

UI evidence

Screenshot From 2026-08-01 22-48-17 image Screenshot From 2026-08-01 22-48-34 Screenshot From 2026-08-01 22-48-24

Compatibility and migration

  • No database migration is required.
  • Filter and view state remains session-scoped.
  • Shelf and topic filters use stable record IDs.
  • Reading-status defaults now use unread; current persisted enum values continue through the PowerSync mapper.
  • Legacy query parser utilities remain available but are no longer wired into library search.

Notes

  • The shelf-page “Add to shelf” action remains intentionally nonfunctional for now.
  • Advanced filters are exposed from the main Books search bar; shelf pages reuse the same filtering infrastructure with shelf-scoped options.

Checklist

  • The branch, commits, and pull request title follow the repository conventions.
  • The change is complete and limited to the ticket's scope.
  • Relevant tests have been added or updated.
  • Formatting, analysis, and tests pass.
  • Documentation, UI evidence, and migration notes are included where relevant.
  • No credentials, personal data, copyrighted fixtures, or unrelated generated files are included.
  • The branch is up to date with its target branch.

@Eoic Eoic self-assigned this Jul 27, 2026
Copilot AI review requested due to automatic review settings July 27, 2026 22:00

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copilot was unable to review this pull request because the user who requested the review has reached their quota limit.

@Eoic
Eoic merged commit bdbb1e0 into master Aug 1, 2026
1 check passed
@Eoic
Eoic deleted the feature/PPR-25-books-page-filters-overhaul branch August 1, 2026 19:59
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants