feat(timeline): add overview mini-map

[chiptus]

Adds a collapsible "Show overview" toggle in the timeline toolbar revealing a proportional mini-map of the filtered edition, with vote-colored set density and a draggable viewport window.
Clicking the map jumps the strip (smooth scroll); dragging the viewport window scrubs it directly.

Closes #197

Verification

• Toggle "Show overview" on the timeline tab; mini-map appears collapsed by default, expands/collapses on click.
• Click anywhere on the mini-map; strip smooth-scrolls there and scrollTo updates in the URL.
• Drag the viewport window left/right; strip scrubs live, then settles into a debounced scrollTo write.
• Apply a day filter (?day=2025-07-12); mini-map shows only that day's sets and density.
• Log out and revisit; mini-map still renders with neutral (unvoted) set colors.

---

Generated by Claude Code

[qodo-code-review]

Qodo reviews are paused for this user.

Troubleshooting steps vary by plan Learn more →

On a Teams plan?
Reviews resume once this user has a paid seat and their Git account is linked in Qodo.
Link Git account →

Using GitHub Enterprise Server, GitLab Self-Managed, or Bitbucket Data Center?
These require an Enterprise plan - Contact us
Contact us →

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
upline	Ready	Preview, Comment	Jul 20, 2026 7:13pm

[Copilot]

Pull request overview

Adds a collapsible “Show overview” mini-map to the horizontal schedule timeline, enabling proportional edition-wide navigation (click-to-jump) and scrubbing (drag viewport) while keeping navigation state in the existing scrollTo URL sync.

Changes:

• Add an overview mini-map UI (per-stage density rows, day-boundary lines, draggable viewport window) gated by a toolbar toggle.
• Centralize “jump to moment” behavior in useTimelineScrollSync().jumpTo, used by both day-jump buttons and the overview map.
• Add/adjust unit + e2e coverage for overview geometry and interactions; refactor day label helpers.

Reviewed changes

Copilot reviewed 24 out of 24 changed files in this pull request and generated 13 comments.

Show a summary per file

File	Description
tests/e2e/timeline-overview.spec.ts	Adds e2e coverage for overview toggle/click/drag/day-filter behavior.
tests/e2e/timeline-day-toolbar.spec.ts	Updates day-jump toolbar e2e assertions to match new DOM/roles.
src/test/setup.ts	Test environment setup adjustments (timezone pin removed in diff).
src/pages/EditionView/tabs/ScheduleTab/horizontal/TimelineToolbar.tsx	Adds “Show overview” toggle button to toolbar.
src/pages/EditionView/tabs/ScheduleTab/horizontal/TimelineOverview.tsx	Implements overview mini-map rendering + click-to-jump.
src/pages/EditionView/tabs/ScheduleTab/horizontal/TimelineContainer.tsx	Wires overview expansion state + integrates jumpTo.
src/pages/EditionView/tabs/ScheduleTab/horizontal/Timeline.tsx	Rehomes StageLabels to keep it pinned outside the scroller.
src/pages/EditionView/tabs/ScheduleTab/horizontal/StageLabels.tsx	Adjusts pinned label positioning within the new container layout.
src/pages/EditionView/tabs/ScheduleTab/horizontal/OverviewViewportWindow.tsx	Adds draggable viewport window for scrubbing the timeline.
src/pages/EditionView/tabs/ScheduleTab/horizontal/OverviewStageRow.tsx	Renders per-stage density blocks with vote-based coloring.
src/pages/EditionView/tabs/ScheduleTab/horizontal/DayJumpButtons.tsx	Simplifies day buttons and updates labels to short weekday+date.
src/main.tsx	Removes router-level defaultStructuralSharing setting.
src/lib/timeUtils.ts	Replaces day-label parts helper with getFestivalDayShortLabel.
src/lib/timeUtils.test.ts	Updates tests for new short label helper and removes adjacency tests.
src/lib/timelineOverviewGeometry.ts	Adds shared geometry helpers for overview proportions and viewport.
src/lib/timelineOverviewGeometry.test.ts	Adds unit tests for overview geometry calculations.
src/lib/timelineDayJump.ts	Simplifies day-jump moment selection to “earliest set start”.
src/lib/timelineDayJump.test.ts	Updates tests to avoid removed fixtures and match new logic.
src/lib/timelineCalculator.test.ts	Removes shared fixtures and inlines test data builders.
src/hooks/useTimelineUrlState.ts	Enables structural sharing to reduce recomputation on scrollTo writes.
src/hooks/useTimelineScrollSync.ts	Adds jumpTo API and enables structural sharing in useSearch.
src/hooks/useActiveTimelineDay.ts	Removes active-day tracking hook (no longer used).
src/tests/fixtures.ts	Removes generic schedule/stage fixture helpers.
CLAUDE.md	Updates agent workflow instruction wording.

[Copilot]

Pull request overview

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

Comments suppressed due to low confidence (3)

src/test/setup.ts:3

• Removing the TZ pin makes date-fns fallbacks depend on the machine timezone (e.g. getFestivalDayKey() uses format(date) when no timezone is passed, and timeUtils.test asserts a UTC fallback). This will make unit tests fail or become non-deterministic on non-UTC machines.

import "@testing-library/jest-dom/vitest";
import { vi } from "vitest";

tests/e2e/timeline-day-toolbar.spec.ts:23

• This locator matches the new "Show/Hide overview" toggle as well as the day-jump buttons, so label assertions/clicks will be wrong (e.g. "Show overview" doesn't match the weekday/date regex). Scope the locator to the day-jump buttons’ data-testid prefix instead.

test.describe("Timeline day-jump toolbar", () => {
  test("renders one sticky button per festival day, labeled weekday + date", async ({
    page,
  }) => {

src/pages/EditionView/tabs/ScheduleTab/horizontal/OverviewViewportWindow.tsx:46

• The viewport window declares role="slider" but isn’t focusable and has no keyboard interactions, which makes it inaccessible (and the ARIA semantics incorrect). Either remove the slider role or make it a real slider by adding tabIndex, aria-valuemin/max, and ArrowLeft/ArrowRight handling.

      data-testid="timeline-overview-viewport"
      role="slider"
      tabIndex={0}
      aria-label="Visible timeline range"
      aria-valuemin={0}

[Copilot]

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

[Copilot]

Pull request overview

Copilot reviewed 11 out of 11 changed files in this pull request and generated 1 comment.

Comments suppressed due to low confidence (5)

src/pages/EditionView/tabs/ScheduleTab/horizontal/TimelineOverview.tsx:137

• If rowHeight is computed as a fractional/very small value (e.g. on festivals with many stages), height={rowHeight - 1} can become 0 or negative, which results in invalid layout (and rows disappearing). Use rowHeight directly (or clamp) for the row height.
  src/pages/EditionView/tabs/ScheduleTab/horizontal/OverviewViewportWindow.tsx:1
• This component adds global window pointer event listeners but doesn't guarantee cleanup if the overview unmounts mid-drag (e.g. user collapses the overview while dragging). That can leave stale listeners running and mutating scrollLeft after unmount. Consider using an AbortController (and aborting on unmount) to ensure listeners are always cleaned up.

import { useRef } from "react";

src/pages/EditionView/tabs/ScheduleTab/horizontal/OverviewViewportWindow.tsx:38

• Track an AbortController for the active drag and abort it on unmount to ensure any in-flight global listeners are removed even if the component is collapsed/unmounted mid-drag.

  const dragStateRef = useRef<DragState | null>(null);

src/pages/EditionView/tabs/ScheduleTab/horizontal/OverviewViewportWindow.tsx:66

• Use the per-drag AbortController signal when registering global listeners so they can be torn down reliably (via abort on pointer-up/cancel or unmount).

    dragStateRef.current = {
      startClientX: event.clientX,
      startScrollLeft: container.scrollLeft,
      mapWidthPx: map.getBoundingClientRect().width,
    };

src/pages/EditionView/tabs/ScheduleTab/horizontal/OverviewViewportWindow.tsx:94

• handlePointerUp can rely on aborting the active drag's AbortController to remove all listeners that were registered with its signal (and clear refs). This avoids leaving listeners attached if the drag ends via cancel/unmount.

    dragStateRef.current = null;
    window.removeEventListener("pointermove", handlePointerMove);
    window.removeEventListener("pointerup", handlePointerUp);
    window.removeEventListener("pointercancel", handlePointerUp);
  }