ReadViewSDK/.planning/phases/04-reader-capabilities/04-02-SUMMARY.md

801 B

04-02 Summary

Outcome

Wave 2 tightened native location, highlight, selection, search, and TOC compatibility around the Phase 3 offset contract.

  • normalizedTextSelection now preserves exclusive end semantics more carefully when rebuilding progressions from RDEPUBTextOffsetRangeInfo
  • Native highlight filtering now compares normalized hrefs, reducing mismatch risk after resolver normalization
  • Search page lookup now prefers exact rangeLocation offset matching before falling back to progression-based page resolution

Compatibility

  • RDEPUBTextOffsetRangeInfo remains the native persisted range format
  • RDEPUBTextContentView still derives visible overlap from pageStartOffset / pageEndOffset
  • No page-local-only identifier replaced the absolute chapter offset contract