Skip to content

fix: improve reader progress, navigation and host-owned panels - #6

Merged
Eoic merged 3 commits into
developmentfrom
fix/reader-navigation-and-shell
Oct 10, 2026
Merged

Eoic merged 3 commits into
developmentfrom
fix/reader-navigation-and-shell

Conversation

@Eoic

@Eoic Eoic commented Oct 10, 2026 •

Copy link
Copy Markdown
Member

Summary

EPUB progress now uses a document-wide content index instead of weighting every spine item equally. SVG-wrapped raster covers render, next/previous and slider navigation agree, and chapter preparation keeps the committed page and progress visible. Adjacent chapter prefetch, bounded layout caching, cancellation, and retry reduce disruptive transitions.

Reader controls are flush overlays with tap-to-toggle behavior, a standard back button, compact progress spacing, and distinct docked panels. Hosts can provide compact panel routes and reuse their own sheet shell while the reader owns panel lifecycle. The current locator contract uses spine indices and content offsets; synthetic CFI compatibility members were removed.

Validation

  • 172 reader tests passed, including offline Alice and Pride and Prejudice fixtures with recorded sources/checksums.
  • Reader analysis, example analysis and two example tests passed; example and client web builds passed.
  • Packaged EPUB worker regeneration check passed; browser transport/EPUB/PDF smoke passed.
  • Actual client sessions in desktop Chrome and an iOS simulator covered real EPUBs, saved positions, controls, panels and PDF navigation. Detailed observations and limitations are in docs/reader-navigation-validation.md.
  • Phone browser capture had a device-scale mismatch; widget geometry and iOS screenshots supplied mobile evidence. No physical-device/e-ink or authenticated live-sync certification.

Integration

The client PR pins this reader commit and supplies the shared Papyrus sheet shell. This is a pre-release API cleanup: no migration shims or version bump are included. Private SQL and PDF validation inputs and local screenshots remain outside committed fixtures.

Review follow-up

Preserve non-wrapper SVG artwork in sanitized HTML and embed its local image resources without flattening mixed/vector content. Wide panels now follow the actual custom toolbar height, including changes while open. Regression tests cover both fixes. The requested overlay/pagination behavior remains unchanged and is now explicit in AGENTS.md.

Copilot AI balanced review requested due to automatic review settings October 10, 2026 18:24

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.

@chatgpt-codex-connector

chatgpt-codex-connector Bot commented Oct 10, 2026 •

Copy link
Copy Markdown

Codex Review Summary

This comment shows the latest Codex review activity on this pull request.

Review Status Commit Review trigger
📝 Code Review ✅ Completed 2026-10-10T18:29:16.634699Z e76d684 PR opened
ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review" or "@codex security review".

Codex reacts with 👀 while any review is running, comments if it has suggestions, and reacts with 👍 once all reviews finish with no findings.

@chatgpt-codex-connector chatgpt-codex-connector Bot 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.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: e76d6849e0

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread lib/src/engine/epub/worker/epub_processor.dart Outdated
Comment thread lib/src/presentation/papyrus_reader.dart Outdated
Comment thread lib/src/presentation/papyrus_reader.dart Outdated
@Eoic
Eoic merged commit 1472919 into development Oct 10, 2026
8 checks passed
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