Persist gallery filter/sort state across navigation

[Copilot]

Gallery filter, sort, search, and view mode state resets whenever the user navigates away (e.g., clicks an image). State should survive round-trips to ImageView and next/prev navigation should respect the active filter.

Changes

ImageGallery.js

• Added optional galleryKey prop (falls back to projectId) for scoped state storage
• All five control states (viewMode, sortBy, searchField, searchValue, reviewFilter) initialized from and persisted to localStorage under key gallery_state_${galleryKey}

GroupGalleryView.js

• Passes a group-scoped galleryKey to ImageGallery so each group gallery maintains independent state:

  galleryKey={isUngrouped ? `${projectId}_ungrouped` : `${projectId}_group_${groupId}`}
  

ImageView.js

• loadProjectImages() now reads the saved gallery state and applies:
  • Search filter — same client-side logic as ImageGallery (filename, metadata, content type, etc.)
  • Review filter — fetches /api/projects/{id}/image-review-statuses if a non-all filter is saved; silently skips on failure
  • Sort order — date / name / size, matching gallery sort

This ensures the prev/next buttons navigate through the same ordered, filtered image set the user last configured.

Original prompt

---

This section details on the original issue you should resolve

<issue_title>Saved Filter/Sort State</issue_title>
<issue_description>Currently if you filter or sort images in the image gallery, it resets as soon as you click an image.

It should save the state of the filter for that user, on that page. So if a user clicks away from that image gallery, say by clicking an image or visiting another page, and then return to that same image gallery, their filter and sort should be what it was when they left.

It should respect the sort and filter state when navigating images via the next/previous buttons as well.</issue_description>

Comments on the Issue (you are @copilot in this section)

• Fixes Saved Filter/Sort State #80

---

💬 Send tasks to Copilot coding agent from Slack and Teams to turn conversations into code. Copilot posts an update in your thread when it's finished.

[Copilot]

Pull request overview

Adds persistent, scoped gallery UI state (filter/sort/search/view mode) so it survives navigation away from the gallery and ensures ImageView prev/next navigation respects the same active filters and ordering.

Changes:

• Introduces shared galleryState utilities for localStorage persistence plus filter/sort application, with unit tests.
• Persists/restores ImageGallery control state via a new optional galleryKey (project- or group-scoped), and includes galleryKey in navigation URLs.
• Updates ImageView to apply saved gallery filters/sorts when building the navigation image list, with additional tests.

Reviewed changes

Copilot reviewed 7 out of 7 changed files in this pull request and generated 6 comments.

Show a summary per file

File	Description
frontend/src/utils/galleryState.js	New shared persistence + filter/sort utilities used by both gallery and ImageView navigation.
frontend/src/utils/tests/galleryState.test.js	Unit tests for persistence and filter/sort helpers.
frontend/src/components/ImageGallery.js	Loads/saves gallery control state to localStorage and appends galleryKey to ImageView navigation URLs.
frontend/src/components/GroupGalleryView.js	Provides a group-scoped galleryKey so each group’s gallery state is independent.
frontend/src/components/tests/ImageGallery.test.js	Extends component tests to validate localStorage persistence/restore and galleryKey URL behavior.
frontend/src/ImageView.js	Applies saved gallery filter/sort (and optional review status filtering) to prev/next navigation list and preserves galleryKey in navigation.
frontend/src/tests/ImageView.test.js	Adds tests around reading saved gallery state for navigation behavior.

[Copilot]

Pull request overview

Adds shared, persisted gallery filter/sort state so users keep their gallery configuration across navigation and ImageView prev/next respects the same filtered + ordered image set (project and group scoped).

Changes:

• Introduces frontend/src/utils/galleryState.js to centralize localStorage persistence, filtering, and sorting logic used by both ImageGallery and ImageView.
• Updates ImageGallery to persist/restore controls via galleryKey-scoped localStorage and to propagate galleryKey through the ImageView URL.
• Updates ImageView navigation list building to apply the saved gallery search/review/sort state, with added frontend test coverage.

Reviewed changes

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

Show a summary per file

File	Description
test/backend_tests.sh	Adds fallback UV_CACHE_DIR when default location isn’t writable.
frontend/src/utils/galleryState.js	New shared persistence + filter/sort utilities with TTL/cap cleanup.
frontend/src/utils/tests/galleryState.test.js	Unit tests for persistence, cleanup, filtering, and sorting helpers.
frontend/src/components/ImageGallery.js	Loads/saves gallery state from localStorage; adds galleryKey prop; appends galleryKey to ImageView links.
frontend/src/components/GroupGalleryView.js	Passes group-/ungrouped-scoped galleryKey to ImageGallery.
frontend/src/components/tests/ImageGallery.test.js	Adds tests covering persisted state behavior and galleryKey URL propagation.
frontend/src/ImageView.js	Applies saved gallery filters/sort to prev/next navigation list; preserves galleryKey across navigation.
frontend/src/tests/ImageView.test.js	Adds navigation tests validating sort/filter behavior and galleryKey preservation.