The live network map: reported vehicle positions on a MapLibre basemap with filters, details and freshness notices.

MapHero composes selection, camera and live-store lifecycle. mapSelectionSession.svelte.ts owns selected-detail retention, URL identity and family leases through focused selection-session modules. mapRuntime owns custom layers, motion, pointer interaction, source feeds, emphasis and cleanup for the mounted map; style reloads restore sources before replaying emphasis. The local overlay and detail components arrange values and pass user actions back to MapHero.

MapFilters owns its disclosure state and delegates filter values to FilterStore. Map tools and independent panels are outside the content-section bulk action and are not governed by sections-choice. MapFilterRail sizes the collapsed rail from its buttons. MapMotionControl uses the raw and smooth store values, saved in localStorage transit:motion-mode: reported positions by default, estimated positions as an explicit choice. Out-of-service vehicles (no trip) are hidden by default; the Out-of-service vehicles filter shows them and is kept in the URL as out_of_service=1.

DetailAttributeGrid owns definition-row layout for both desktop and mobile details: label, value and action on one 44 px line. The action column is always reserved, so every value starts at the same position; nested messages keep their own layout. MapHeadTitle and MapFeedStallBanner keep mobile freshness and notices clear of the heading without changing announcement priority.

MapFreshness labels report age independently of current feed availability. A failed vehicle feed keeps the report timestamp and caution state; MapFeedStallBanner names the unavailable positions. A partial stall uses “Data may be out of date” / “Les données peuvent ne plus être à jour.” Whole-feed outage wording requires every active family to be stale; a loading family cannot certify that outage. Last-update timestamps remain visible.

vehicleSprites owns marker geometry and vehicleLayer applies its scaled offsets. The bus stays at the reported coordinate; the heading clears its silhouette, and status/stale badges share a row below it. Geometry changes need bearing, zoom, badge-pair and picking checks.

Vehicle motion and Estimated positions

createVehicleMotion decides what the overlay draws; the map runtime owns the overlay's lifetime. It animates only when the preference is smooth, reduced motion is off and the map is ready. The UI calls the result Estimated positions, with Estimated and Reported labels.

An estimated position moves the vehicle along its route shape by reported speed × fix age, with the age capped at the horizon. A position is held at the vehicle's next stop only when that stop is more than 5 m ahead along the shape. Timing comes from liveTimingFor, reading the manifest's ttl_s and source_lag_s:

The motion controller blends from the previous drawn position over 1.5 s with an ease-out, renders at most 30 frames per second and stops its frame loop when nothing moves, waking for the next change. Its held-frame expiry and wake timer use a fixed 150 s (see Decisions and limitations).

Map camera

createMapCamera and initialCamera own camera intents and recovery; the initial zoom is 11. mapCameraFraming.ts fits the provider's fit_bounds, falling back to the manifest bbox. mapViewportOptions keeps provider framing centered on the screen and moves it only enough to clear an open panel; when that zoom cannot clear both edges it fits into the uncovered area. measureMapFocusInset in mapFocusInset.ts measures the chrome that covers the map.

Selection panel, hover card and bottom sheet

Basemap

Each provider has its own Protomaps extract at public.basemap_url, cut to public.basemap_bounds (see Providers). refresh-basemap.yml runs at 06:00 UTC on the first of each month and on dispatch (optional provider and planet_build inputs). It extracts each provider's area from a Protomaps daily build to zoom 15, requires more than 100,000 bytes, and replaces the stable R2 object after writing a backup and reading it back. The map background uses the palette's land color, the same as the earth layer (basemap.ts). Production observation, November 10, 2026: the published archives come from the 2026-11-08 build (STM 176,104,928 bytes, OC Transpo 187,632,265 bytes); this records object sizes only, not rendering.

Checks

Run the map tests from apps/web with bun run test src/lib/features/map. Browser review also needs both desktop panels independently and together, touch controls, selection, empty positions, feed failure, renderer retry and reduced motion. Panel changes must leave the map canvas dimensions unchanged.