Make track review in the session view clearer and faster, from partner feedback

[mihow]

Summary

A partner's evaluation of the tracking tools produced a list of interface requests from people reviewing tracks frame by frame. This PR works through the ones that need only frontend changes. The session view is less cluttered: path crops are hidden until asked for, and the track panel no longer scales with the zoom or gets cut off at the image's edge. Reviewers can see the names the classifier gave each frame, jump to a track's first or last frame, open the original photo behind a crop, and sort merge candidates by one column and then another.

This PR is stacked on #1432 and should be reviewed and merged after it.

List of Changes

#	Change (user effect)	How	Notes
1	Along a track's path, only the outlines of other frames are drawn by default. The existing "Show crops in path" toggle turns the crops on, and the browser remembers the choice.	showPathCrops moves into the user preferences store (default off). That store's localStorage reads and writes are now wrapped in try/catch.	Storing it follows the same cookie-consent rule as the other preferences. Without functional-cookie consent, the toggle lasts only for the visit.
2	The panel on a capture's box stays at normal size at any zoom level. It flips or shifts to stay in the window, scrolls when it is taller than the space available, and disappears when its box is panned out of view.	Box panels and tooltips render through a Radix portal (hideWhenDetached, viewport collision, max-h from --radix-popover-content-available-height). A zoom or pan sends a scroll event so the panel repositions. A faded panel does not catch clicks.	Before this change, zooming in scaled the panel with the image and cut it off.
3	The merge picker is sortable by several columns: click Frames, then Species, to get species A to Z with frame counts breaking ties. The header numbers the tie-breaking columns, and the order control shows the full order ("Species, then frames").	addSortColumn builds a list of up to 3 keys, and sortMergeCandidates applies them in order.	The server ranking remains the default.
4	The track panel in the session view lists the names the classifier gave the frames, e.g. "Species A ×7, No classification ×2".	formatFrameNames over the existing frameNames from occurrence details.	Uses the existing per-frame label rule: a terminal classification wins over a moth/non-moth filter.
5	Once the path is shown, the track panel has "First frame" and "Last frame" buttons. Each frame in an occurrence's frame list has an icon that opens the full capture it was cropped from.	getPathEnds in track-navigation.ts. The frame caption links to detection.capture.url, which the occurrence detail already returns.	Buttons are disabled when the viewer is already on that frame.

Selecting several merge candidates and merging them in one action was also requested. #1432 already supports this, and it was confirmed in the browser ("Merge 2 occurrences"), so this PR does not change it.

Detailed Description

How this was tested

• tsc --noEmit, yarn lint and yarn test all pass (39 suites, 240 tests). There are new unit tests for the preference store (default value, persistence, storage that throws), the multi-column sort, the frame-name formatter, the path ends and the frame's capture link.
• Checked in a browser against a local copy of the evaluation data, using a Vite dev server:
  • Path crops are off on first load. After turning them on, they are still on after a reload.
  • Zoomed to 60%: before this change, the panel was drawn at 3x size and clipped. After it, the panel stays normal size and hides while its box is off screen. It returns after Reset.
  • Clicking "Last frame" on a 14-frame track stepped the viewer from capture 169 to capture 180, and the button then became disabled.
  • Clicking Frames and then Species ordered the candidates by species, with frames breaking ties. The Frames header showed a "2".
  • A two-frame track with two different frame names listed both on its panel.

The screenshots from the browser check (before and after zoom, default path view, panel with names and first/last buttons, frame capture link, multi-column sort) are held locally and not uploaded, because PR images cannot be attached from the CLI.

Not covered here

• The comparison preview in the merge picker is still positioned with a fixed height estimate. In the checks it measured exactly that height, but a longer verdict text could push it a few pixels past the bottom of the window.
• The panel is now portalled, so near the bottom of the window it can overlap the capture navigation bar. It scrolls instead of being cut off.

🤖 Generated with Claude Code

https://claude.ai/code/session_01C7Xf6VPbwWtTumhjjF15g8

[netlify]

✅ Deploy Preview for antenna-preview canceled.

Name	Link
🔨 Latest commit	0eada49
🔍 Latest deploy log	https://app.netlify.com/projects/antenna-preview/deploys/6abd5de11732da00084edd89

[coderabbitai]

Important

Draft PR not reviewed

Draft PRs are not automatically reviewed by default.

• Trigger a manual review

To automatically review draft PRs, update your CodeRabbit configuration:

reviews:
  auto_review:
    drafts: true

• Autopilot · Keep fixing CodeRabbit findings and required CI, and resolving merge conflicts

Autopilot is currently an internal CodeRabbit preview.

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}

[mihow]

Claude says: The merge order and plan for tracking, agreed with the owner today, are on #1412: #1412 (comment)

This PR's place: its review improvements feed the smaller review PRs that follow #1469 (#1431, #1433).