chore(release): 4.68.2 [skip ci]

## [4.68.2](https://github.com/antialias/soroban-abacus-flashcards/compare/v4.68.1...v4.68.2) (2025-10-23)

### Bug Fixes

* **complement-race:** prevent passenger delivery render loop causing thrashing ([f637ddf](f637ddfdb8))

CHANGELOG.md

@@ -1,3 +1,17 @@
+## [4.68.2](https://github.com/antialias/soroban-abacus-flashcards/compare/v4.68.1...v4.68.2) (2025-10-23)
+
+
+### Bug Fixes
+
+* **complement-race:** prevent passenger delivery render loop causing thrashing ([f637ddf](https://github.com/antialias/soroban-abacus-flashcards/commit/f637ddfdb8a62c85ebf8f08c35927af9ebcdf0d7))
+
+## [4.68.1](https://github.com/antialias/soroban-abacus-flashcards/compare/v4.68.0...v4.68.1) (2025-10-23)
+
+
+### Performance Improvements
+
+* **complement-race:** increase spring animation responsiveness to reduce lag ([5bd0dad](https://github.com/antialias/soroban-abacus-flashcards/commit/5bd0dadfdf9d6d81d7db4374983e40de00effecb))
+
 ## [4.68.0](https://github.com/antialias/soroban-abacus-flashcards/compare/v4.67.1...v4.68.0) (2025-10-22)
 
 

apps/web/src/app/arcade/complement-race/components/RaceTrack/GhostTrain.tsx

@@ -89,7 +89,7 @@ export function GhostTrain({
     y: locomotiveTarget?.y ?? 0,
     rotation: locomotiveTarget?.rotation ?? 0,
     opacity: locomotiveTarget?.opacity ?? 1,
-    config: { tension: 280, friction: 60 }, // Smooth but responsive
+    config: { tension: 600, friction: 35 }, // Fast/responsive to match local train
   })
 
   // Calculate target transforms for cars (used by spring animations)
@@ -133,7 +133,7 @@ export function GhostTrain({
       y: target.y,
       rotation: target.rotation,
       opacity: target.opacity,
-      config: { tension: 280, friction: 60 },
+      config: { tension: 600, friction: 35 }, // Fast/responsive to match local train
     }))
   )
 

apps/web/src/app/arcade/complement-race/hooks/useSteamJourney.ts

@@ -45,6 +45,7 @@ export function useSteamJourney() {
   const routeExitThresholdRef = useRef<number>(107) // Default for 1 car: 100 + 7
   const missedPassengersRef = useRef<Set<string>>(new Set()) // Track which passengers have been logged as missed
   const pendingBoardingRef = useRef<Set<string>>(new Set()) // Track passengers with pending boarding requests across frames
+  const pendingDeliveryRef = useRef<Set<string>>(new Set()) // Track passengers with pending delivery requests across frames
   const previousTrainPositionRef = useRef<number>(0) // Track previous position to detect threshold crossings
 
   // Initialize game start time
@@ -65,19 +66,23 @@ export function useSteamJourney() {
     }
   }, [state.currentRoute, state.passengers, state.stations, state.maxConcurrentPassengers])
 
-  // Clean up pendingBoardingRef when passengers are claimed/delivered or route changes
+  // Clean up pendingBoardingRef and pendingDeliveryRef when passengers are claimed/delivered or route changes
   useEffect(() => {
-    // Remove passengers from pending set if they've been claimed or delivered
+    // Remove passengers from pending sets if they've been claimed or delivered
     state.passengers.forEach((passenger) => {
       if (passenger.claimedBy !== null || passenger.deliveredBy !== null) {
         pendingBoardingRef.current.delete(passenger.id)
       }
+      if (passenger.deliveredBy !== null) {
+        pendingDeliveryRef.current.delete(passenger.id)
+      }
     })
   }, [state.passengers])
 
-  // Clear all pending boarding requests when route changes
+  // Clear all pending boarding and delivery requests when route changes
   useEffect(() => {
     pendingBoardingRef.current.clear()
+    pendingDeliveryRef.current.clear()
     missedPassengersRef.current.clear()
     previousTrainPositionRef.current = 0 // Reset previous position for new route
   }, [state.currentRoute])
@@ -159,6 +164,9 @@ export function useSteamJourney() {
       currentBoardedPassengers.forEach((passenger) => {
         if (!passenger || passenger.deliveredBy !== null || passenger.carIndex === null) return
 
+        // Skip if delivery already dispatched (prevents render loop spam)
+        if (pendingDeliveryRef.current.has(passenger.id)) return
+
         const station = state.stations.find((s) => s.id === passenger.destinationStationId)
         if (!station) return
 
@@ -172,6 +180,10 @@ export function useSteamJourney() {
           console.log(
             `🎯 DELIVERY: ${passenger.name} delivered from Car ${passenger.carIndex} to ${station.emoji} ${station.name} (+${points} pts) (trainPos=${trainPosition.toFixed(1)}, carPos=${carPosition.toFixed(1)}, stationPos=${station.position})`
           )
+
+          // Mark as pending BEFORE dispatch to prevent duplicate delivery attempts across frames
+          pendingDeliveryRef.current.add(passenger.id)
+
           dispatch({
             type: 'DELIVER_PASSENGER',
             passengerId: passenger.id,

apps/web/src/app/arcade/complement-race/hooks/useTrainTransforms.ts

@@ -41,7 +41,7 @@ export function useTrainTransforms({
     x: locomotiveTarget.x,
     y: locomotiveTarget.y,
     rotation: locomotiveTarget.rotation,
-    config: { tension: 280, friction: 60 },
+    config: { tension: 600, friction: 35 }, // Fast/responsive to avoid lag
   })
 
   // Calculate target transforms for train cars (each car follows behind the locomotive)
@@ -98,7 +98,7 @@ export function useTrainTransforms({
       rotation: target.rotation,
       opacity: target.opacity,
       position: target.position,
-      config: { tension: 280, friction: 60 },
+      config: { tension: 600, friction: 35 }, // Fast/responsive to avoid lag
     }))
   )
 
@@ -128,7 +128,7 @@ export function useTrainTransforms({
   // Animated spring for smooth locomotive opacity
   const locomotiveOpacity = useSpring({
     opacity: locomotiveOpacityTarget,
-    config: { tension: 280, friction: 60 },
+    config: { tension: 600, friction: 35 }, // Fast/responsive to avoid lag
   })
 
   return {

package.json

@@ -1,6 +1,6 @@
 {
   "name": "soroban-monorepo",
-  "version": "4.68.0",
+  "version": "4.68.2",
   "private": true,
   "description": "Beautiful Soroban Flashcard Generator - Monorepo",
   "workspaces": [