From ee69c62adc5943a1dbd154df5142c0e726bdd317 Mon Sep 17 00:00:00 2001
From: Ariel Costas Guerrero <ariel@costas.dev>
Date: Fri, 13 Mar 2026 16:49:10 +0100
Subject: feat(routes): add realtime estimates panel with pattern-aware styling

- New GET /api/stops/estimates endpoint (nano mode: tripId, patternId, estimate, delay only)
- useStopEstimates hook wiring estimates to routes-$id stop panel
- Pattern-aware styling: dim schedules and estimates from other patterns
- Past scheduled departures shown with strikethrough instead of hidden
- Persist selected pattern in URL hash (replace navigation, no history push)
- Fix planner arrivals using new estimates endpoint
---
 src/frontend/app/api/arrivals.ts | 30 ++++++++++++++++++++++++++++++
 src/frontend/app/api/schema.ts   | 14 +++++++++++++-
 2 files changed, 43 insertions(+), 1 deletion(-)

(limited to 'src/frontend/app/api')

diff --git a/src/frontend/app/api/arrivals.ts b/src/frontend/app/api/arrivals.ts
index 8ae6e78..ad99630 100644
--- a/src/frontend/app/api/arrivals.ts
+++ b/src/frontend/app/api/arrivals.ts
@@ -1,6 +1,8 @@
 import {
   StopArrivalsResponseSchema,
+  StopEstimatesResponseSchema,
   type StopArrivalsResponse,
+  type StopEstimatesResponse,
 } from "./schema";
 
 export const fetchArrivals = async (
@@ -29,3 +31,31 @@ export const fetchArrivals = async (
     throw e;
   }
 };
+
+export const fetchEstimates = async (
+  stopId: string,
+  routeId: string,
+  viaStopId?: string
+): Promise<StopEstimatesResponse> => {
+  let url = `/api/stops/estimates?stop=${encodeURIComponent(stopId)}&route=${encodeURIComponent(routeId)}`;
+  if (viaStopId) {
+    url += `&via=${encodeURIComponent(viaStopId)}`;
+  }
+
+  const resp = await fetch(url, {
+    headers: { Accept: "application/json" },
+  });
+
+  if (!resp.ok) {
+    throw new Error(`HTTP ${resp.status}: ${resp.statusText}`);
+  }
+
+  const data = await resp.json();
+  try {
+    return StopEstimatesResponseSchema.parse(data);
+  } catch (e) {
+    console.error("Zod parsing failed for estimates:", e);
+    console.log("Received data:", data);
+    throw e;
+  }
+};
diff --git a/src/frontend/app/api/schema.ts b/src/frontend/app/api/schema.ts
index 0c55969..f68d413 100644
--- a/src/frontend/app/api/schema.ts
+++ b/src/frontend/app/api/schema.ts
@@ -64,10 +64,16 @@ export const ArrivalSchema = z.object({
   shift: ShiftBadgeSchema.optional().nullable(),
   shape: z.any().optional().nullable(),
   currentPosition: PositionSchema.optional().nullable(),
-  stopShapeIndex: z.number().optional().nullable(),
   vehicleInformation: VehicleInformationSchema.optional().nullable(),
 });
 
+export const ArrivalEstimateSchema = z.object({
+  tripId: z.string(),
+  patternId: z.string().optional().nullable(),
+  estimate: ArrivalDetailsSchema,
+  delay: DelayBadgeSchema.optional().nullable(),
+});
+
 export const StopArrivalsResponseSchema = z.object({
   stopCode: z.string(),
   stopName: z.string(),
@@ -77,6 +83,10 @@ export const StopArrivalsResponseSchema = z.object({
   usage: z.array(BusStopUsagePointSchema).optional().nullable(),
 });
 
+export const StopEstimatesResponseSchema = z.object({
+  arrivals: z.array(ArrivalEstimateSchema),
+});
+
 export type RouteInfo = z.infer<typeof RouteInfoSchema>;
 export type HeadsignInfo = z.infer<typeof HeadsignInfoSchema>;
 export type ArrivalPrecision = z.infer<typeof ArrivalPrecisionSchema>;
@@ -85,8 +95,10 @@ export type DelayBadge = z.infer<typeof DelayBadgeSchema>;
 export type ShiftBadge = z.infer<typeof ShiftBadgeSchema>;
 export type Position = z.infer<typeof PositionSchema>;
 export type Arrival = z.infer<typeof ArrivalSchema>;
+export type ArrivalEstimate = z.infer<typeof ArrivalEstimateSchema>;
 export type BusStopUsagePoint = z.infer<typeof BusStopUsagePointSchema>;
 export type StopArrivalsResponse = z.infer<typeof StopArrivalsResponseSchema>;
+export type StopEstimatesResponse = z.infer<typeof StopEstimatesResponseSchema>;
 
 // Transit Routes
 export const RouteSchema = z.object({
-- 
cgit v1.3