Provider catalog for villa-tablet browse overlay + featured carousel. Returns validated providers ordered best-first for the given coordinates (nearest first when coords provided, rating-desc fallback when absent)

Response: { providers: [ { id, name, category, subcategory?, description?, imageUrl?, priceFrom?, distanceKm?, rating? } ] } Only id/name/category are guaranteed; the rest are null when the schema has no data for a row. Defaults to 25 providers; limit accepts up to 500.

category/subcategory are the slugs of the provider's first custom-service category and subcategory (Str::slug(name_en)); category is "other" when no services exist, subcategory is null when the first service has none. The subcategory helps distinguish services because the top-level taxonomy is coarse (private chefs share the "house-home" category with cleaners). priceFrom is the lowest getBasePrice() across all the provider's services. rating is the 0–5 star normalised fred_score (same formula as searchServices). distanceKm is haversine distance from the supplied lat/lng; null when absent.