Switch "Copy Link to Highlight" to use custom highlight rendering + beginnings of annotations support

[cdrini]

Various code review refactors / fixes to #1538 . Created a separate PR so that we can keep the original for any before/after testing we might want to do.

Known issues:

• Does not work if selected text contains hyphen; eg http://127.0.0.1:8000/BookReaderDemo/demo-internetarchive.html?ocaid=theworksofplato01platiala#page/176/mode/2up ; select "with in-justice" and choose copy link to highlight
• Does not work if selecting first line of page; eg https://deploy-preview-1538--ia-bookreader.netlify.app/details/theworksofplato01platiala/page/177/mode/2up?text=from%20this%20evU.-,GORGIAS.,-177&dIndex=188
• Does not work if selecting last line of page; https://deploy-preview-1538--ia-bookreader.netlify.app/details/theworksofplato01platiala/page/176/mode/2up?text=a%20means%20of-,freedom%20from%20this%20evU.,-GORGIAS.%20177&dIndex=187
• It never shortens the text in the url, even when unambiguous
• Cannot select target text? Possibly related to using MARK elements instead of SPAN?
• Show confirmation
• Confirmation should maintain width of original text to avoid disappearing from hover region
• Learn more link broken ; text wrong
• Landing on a link with "text" param and then scrolling around creates a bad link if you copy/paste it. Should always include the pagenum in the "text" param to make it work
• Multiline entire paragraph fails; eg http://127.0.0.1:8000/BookReaderDemo/demo-internetarchive.html?ocaid=theworksofplato01platiala&text=177:So%20it%20seems.-,78.%20Socr.%20Was%20not%20this%20the%20point%2C%20my%20friend%2C%20with%20respect%20to%20which%20we%20differed%2C%20you%20considering%20Archelaus%20happy%2C%20for%20that%20having%20committed%20the%20greatest%20injustice%20he%20suffers%20no%20punishment%3B%20but%20I%20on%20the%20contrary%20thinking%2C%20that%20whether%20Archelaus%2C%20or%20any%20other%20man%20whatever%2C%20is%20not%20punished%20when%20he%20commits%20injustice%2C%20he%20must%20needs%20be%20far%20more%20wretched%20than%20all%20other%20men%2C%20and%20that%20he%20who%20commits%20injustice%20is%20ever%20more%20wretched%20than%20he%20who%20suffers%20it%2C%20and%20he%20that%20is%20not%20punished%20than%20he%20that%20is.%20Are%20not%20these%20the%20things%20that%20I%20said%20%3F,-Pol.%20Yes.#page/177/mode/2up

[codecov]

Codecov Report

❌ Patch coverage is 17.08543% with 330 lines in your changes missing coverage. Please review.
✅ Project coverage is 62.80%. Comparing base (452800b) to head (02b848c).
⚠️ Report is 1 commits behind head on master.

Files with missing lines	Patch %	Lines
src/util/TextSelectionManager.js	16.00%	308 Missing and 7 partials ⚠️
src/plugins/plugin.text_selection.js	23.07%	10 Missing ⚠️
src/BookReader.js	33.33%	2 Missing ⚠️
src/plugins/url/plugin.url.js	60.00%	2 Missing ⚠️
src/plugins/url/UrlPlugin.js	0.00%	1 Missing ⚠️

Additional details and impacted files

@@            Coverage Diff             @@
##           master    #1548      +/-   ##
==========================================
- Coverage   65.79%   62.80%   -3.00%     
==========================================
  Files          67       67              
  Lines        5853     6108     +255     
  Branches     1276     1333      +57     
==========================================
- Hits         3851     3836      -15     
- Misses       1968     2231     +263     
- Partials       34       41       +7     

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
• 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

[Copilot]

Pull request overview

This PR refactors “Copy Link to Highlight” away from native browser text fragments toward a BookReader-specific text fragment format and custom highlight rendering, and introduces early scaffolding for private (localStorage-backed) highlights/annotations.

Changes:

• Introduces BookReaderTextFragment serialization/parsing plus DOM-based highlight rendering (renderHighlight) and localStorage-backed saved highlights.
• Updates URL handling to parse ?text= into a BookReaderTextFragment and render the target highlight when the relevant page becomes visible.
• Adds/adjusts experiments + selection UI and reorganizes/moves tests around the new utilities.

Reviewed changes

Copilot reviewed 11 out of 11 changed files in this pull request and generated 14 comments.

Show a summary per file

File	Description
src/util/TextSelectionManager.js	Adds BookReaderTextFragment, highlight rendering, BRSelectMenu changes, and localStorage highlight support.
src/plugins/url/plugin.url.js	Parses ?text= into targetTextFragment and renders target highlight on textLayerVisible.
src/plugins/url/UrlPlugin.js	Simplifies getHash() now that text fragments are no longer appended into the hash.
src/BookReader.js	Attempts to preserve text query param handling via BookReaderTextFragment during querystring rebuilds.
src/plugins/plugin.text_selection.js	Adds an API to enable the highlight/annotation menu.
src/plugins/plugin.experiments.js	Updates copy-link experiment metadata and adds an “annotateHighlight” experiment toggle.
src/css/_TextSelection.scss	Adds BR highlight styling and prevents hiding text layers containing highlights.
src/css/_BRpages.scss	Prevents hiding highlighted text layers during page flip animations.
tests/jest/util/TextSelectionManager.test.js	Moves walkBetweenNodes tests here and attempts to adapt to new fragment logic (currently skips fragment tests).
tests/jest/plugins/plugin.text_selection.test.js	Removes walkBetweenNodes tests now moved to util tests.
tests/jest/plugins/url/plugin.url.test.js	Updates mock URL plugin surface (adds parseToText).

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[Copilot]

Pull request overview

Copilot reviewed 12 out of 12 changed files in this pull request and generated 5 comments.

[Copilot]

Pull request overview

Copilot reviewed 12 out of 12 changed files in this pull request and generated no new comments.