Add Worth the Drive fuel savings with road-routed estimates

Optional Fuel Savings feature (off by default): vehicle MPG in UK imperial gallons, fill amount in pounds or litres, persisted through the existing keychain/app-group store. Ranks the WHOLE station pool by estimated net saving (fuel-price saving at each pump minus the extra return-trip driving cost) using MapKit road distances with a straight-line fallback marked (est.).

The closest station with a valid price for the selected fuel is the comparison baseline and is labelled "Closest station"; other rows read "Save £X.XX after travel" / "£X.XX worse off after travel" / "Break even". Labels live in the shared model so they are unit-tested. The TOP badge still marks the cheapest pump price and reads "CHEAPEST" when the list is ranked by net saving.

Road routing now prioritises the Worth-the-Drive candidates plus the baseline and merges cache entries instead of replacing them, so far-out stations get real routes rather than permanent straight-line estimates. Numeric fields gain a Done button above the keypad (decimalPad has no Return key); the fill-up control is hidden unless the feature is configured; Favourites shares one session fill amount with the station list. 131 tests.

This commit is contained in:

FuelBoard Contributor

2026-10-11 14:34:53 +01:00

parent 1044d009ae

commit d7a0ecb79a

17 changed files with 1865 additions and 46 deletions

									
										FuelBoardTests/Sources/FuelBoardShared/FuelSavings.swift
									
Symlink

		+1
		
												View File
												
				@@ -0,0 +1 @@

				../../../Shared/FuelSavings.swift

				`@@ -0,0 +1 @@`
				`../../../Shared/FuelSavings.swift`