import { describe, it, expect, vi, beforeEach } from 'vitest' import { render, screen, waitFor, fireEvent } from '../../../tests/helpers/render' import { resetAllStores } from '../../../tests/helpers/store' import { useSettingsStore } from '../../store/settingsStore' import WeatherWidget from './WeatherWidget' vi.mock('../../api/client', async (importOriginal) => { const original = await importOriginal() as any return { ...original, weatherApi: { get: vi.fn(), }, } }) // Import after mock so we get the mocked version import { weatherApi } from '../../api/client' const buildWeather = (overrides = {}) => ({ temp: 20, main: 'Clear', description: 'clear sky', type: 'forecast', ...overrides, }) beforeEach(() => { sessionStorage.clear() vi.clearAllMocks() resetAllStores() }) describe('WeatherWidget', () => { it('FE-COMP-WEATHERWIDGET-001: renders nothing when lat or lng is null', () => { const { container } = render( ) expect(container.firstChild).toBeNull() }) it('FE-COMP-WEATHERWIDGET-002: shows loading indicator while fetching', () => { vi.mocked(weatherApi.get).mockReturnValue(new Promise(() => {})) render() expect(screen.getByText('…')).toBeInTheDocument() }) it('FE-COMP-WEATHERWIDGET-003: shows error dash when fetch fails', async () => { vi.mocked(weatherApi.get).mockRejectedValue(new Error('Network error')) render() await waitFor(() => { expect(screen.getByText('—')).toBeInTheDocument() }) }) it('FE-COMP-WEATHERWIDGET-004: shows error dash when API returns error field', async () => { vi.mocked(weatherApi.get).mockResolvedValue({ temp: 0, main: '', description: '', type: '', error: 'Not available' }) render() await waitFor(() => { expect(screen.getByText('—')).toBeInTheDocument() }) }) it('FE-COMP-WEATHERWIDGET-005: displays temperature in Celsius', async () => { vi.mocked(weatherApi.get).mockResolvedValue(buildWeather({ temp: 20 })) useSettingsStore.setState({ settings: { ...useSettingsStore.getState().settings, temperature_unit: 'celsius' } }) render() await waitFor(() => { expect(screen.getByText('20°C')).toBeInTheDocument() }) }) it('FE-COMP-WEATHERWIDGET-006: converts temperature to Fahrenheit', async () => { vi.mocked(weatherApi.get).mockResolvedValue(buildWeather({ temp: 20 })) useSettingsStore.setState({ settings: { ...useSettingsStore.getState().settings, temperature_unit: 'fahrenheit' } }) render() await waitFor(() => { expect(screen.getByText('68°F')).toBeInTheDocument() }) }) it('FE-COMP-WEATHERWIDGET-007: shows "Ø" prefix for climate data', async () => { vi.mocked(weatherApi.get).mockResolvedValue(buildWeather({ temp: 15, main: 'Clouds', type: 'climate' })) useSettingsStore.setState({ settings: { ...useSettingsStore.getState().settings, temperature_unit: 'celsius' } }) render() await waitFor(() => { expect(screen.getByText(/Ø/)).toBeInTheDocument() }) }) it('FE-COMP-WEATHERWIDGET-008: compact mode renders inline without description', async () => { vi.mocked(weatherApi.get).mockResolvedValue(buildWeather({ description: 'clear sky' })) useSettingsStore.setState({ settings: { ...useSettingsStore.getState().settings, temperature_unit: 'celsius' } }) const { container } = render( ) await waitFor(() => { expect(screen.getByText('20°C')).toBeInTheDocument() }) expect(screen.queryByText('clear sky')).not.toBeInTheDocument() // Outer element should be a span const tempSpan = screen.getByText('20°C') expect(tempSpan.closest('span')).toBeInTheDocument() expect(container.querySelector('div')).toBeNull() }) it('FE-COMP-WEATHERWIDGET-009: non-compact mode shows description', async () => { vi.mocked(weatherApi.get).mockResolvedValue(buildWeather({ description: 'clear sky' })) useSettingsStore.setState({ settings: { ...useSettingsStore.getState().settings, temperature_unit: 'celsius' } }) render() await waitFor(() => { expect(screen.getByText('clear sky')).toBeInTheDocument() }) }) it('FE-COMP-WEATHERWIDGET-010: uses fresh cached data from sessionStorage without refetching', async () => { const cached = buildWeather({ temp: 20 }) sessionStorage.setItem('weather_48.86_2.35_2025-06-01_en', JSON.stringify({ data: cached, fetchedAt: Date.now() })) useSettingsStore.setState({ settings: { ...useSettingsStore.getState().settings, temperature_unit: 'celsius' } }) render() await waitFor(() => { expect(screen.getByText('20°C')).toBeInTheDocument() }) expect(weatherApi.get).not.toHaveBeenCalled() }) it('FE-COMP-WEATHERWIDGET-011: re-fetches in background for cached climate data', async () => { const climateData = buildWeather({ temp: 15, main: 'Clouds', type: 'climate', description: 'cloudy' }) const forecastData = buildWeather({ temp: 22, main: 'Clear', type: 'forecast', description: 'clear sky' }) sessionStorage.setItem('weather_48.86_2.35_2025-06-01_en', JSON.stringify({ data: climateData, fetchedAt: Date.now() })) vi.mocked(weatherApi.get).mockResolvedValue(forecastData) useSettingsStore.setState({ settings: { ...useSettingsStore.getState().settings, temperature_unit: 'celsius' } }) render() // Initially shows climate data await waitFor(() => { expect(screen.getByText(/Ø/)).toBeInTheDocument() }) // After background fetch resolves, shows forecast data await waitFor(() => { expect(screen.getByText('22°C')).toBeInTheDocument() }) expect(screen.queryByText(/Ø/)).not.toBeInTheDocument() }) // #2167 — a standalone PWA keeps sessionStorage alive across days, so a // forecast fetched before the trip was still shown unchanged on the day itself. it('FE-COMP-WEATHERWIDGET-012: revalidates a forecast cache entry older than the TTL', async () => { const staleData = buildWeather({ temp: 20 }) const freshData = buildWeather({ temp: 22 }) sessionStorage.setItem( 'weather_48.86_2.35_2025-06-01_en', JSON.stringify({ data: staleData, fetchedAt: Date.now() - 2 * 60 * 60 * 1000 }), ) vi.mocked(weatherApi.get).mockResolvedValue(freshData) useSettingsStore.setState({ settings: { ...useSettingsStore.getState().settings, temperature_unit: 'celsius' } }) render() // Serve-then-revalidate: the stale value renders immediately … await waitFor(() => { expect(screen.getByText(/20°C|22°C/)).toBeInTheDocument() }) // … and the background refresh replaces it and the cache entry. await waitFor(() => { expect(screen.getByText('22°C')).toBeInTheDocument() }) expect(weatherApi.get).toHaveBeenCalledTimes(1) const stored = JSON.parse(sessionStorage.getItem('weather_48.86_2.35_2025-06-01_en')!) expect(stored.data.temp).toBe(22) expect(typeof stored.fetchedAt).toBe('number') }) it('FE-COMP-WEATHERWIDGET-013: treats a pre-TTL raw cache entry as stale and refreshes it', async () => { // Live PWA sessions still hold entries in the old bare-result format. sessionStorage.setItem('weather_48.86_2.35_2025-06-01_en', JSON.stringify(buildWeather({ temp: 18 }))) vi.mocked(weatherApi.get).mockResolvedValue(buildWeather({ temp: 25 })) useSettingsStore.setState({ settings: { ...useSettingsStore.getState().settings, temperature_unit: 'celsius' } }) render() await waitFor(() => { expect(screen.getByText('25°C')).toBeInTheDocument() }) expect(weatherApi.get).toHaveBeenCalledTimes(1) }) // #2167 (mrwulf) — the widget must be able to say WHERE the forecast is for. it('FE-COMP-WEATHERWIDGET-014: renders locationName as a tooltip title', async () => { vi.mocked(weatherApi.get).mockResolvedValue(buildWeather({ temp: 20 })) useSettingsStore.setState({ settings: { ...useSettingsStore.getState().settings, temperature_unit: 'celsius' } }) render() await waitFor(() => { expect(screen.getByText('20°C')).toBeInTheDocument() }) expect(screen.getByTitle('Rome')).toBeInTheDocument() }) it('FE-COMP-WEATHERWIDGET-015: sends the user language and keys the cache by it', async () => { vi.mocked(weatherApi.get).mockResolvedValue(buildWeather({ temp: 20 })) useSettingsStore.setState({ settings: { ...useSettingsStore.getState().settings, temperature_unit: 'celsius', language: 'de' } }) render() await waitFor(() => { expect(screen.getByText('20°C')).toBeInTheDocument() }) expect(weatherApi.get).toHaveBeenCalledWith(48.86, 2.35, '2025-06-01', 'de') expect(sessionStorage.getItem('weather_48.86_2.35_2025-06-01_de')).not.toBeNull() }) // The day-local anchor (#2167) moves whenever the day is edited, so a single // failed lookup must not keep the badge on the dash for the widget's lifetime. it('FE-COMP-WEATHERWIDGET-016: clears the error dash once a new anchor resolves', async () => { vi.mocked(weatherApi.get).mockRejectedValueOnce(new Error('Network error')) vi.mocked(weatherApi.get).mockResolvedValue(buildWeather({ temp: 21 })) useSettingsStore.setState({ settings: { ...useSettingsStore.getState().settings, temperature_unit: 'celsius' } }) const { rerender } = render() await waitFor(() => { expect(screen.getByText('—')).toBeInTheDocument() }) rerender() await waitFor(() => { expect(screen.getByText('21°C')).toBeInTheDocument() }) expect(screen.queryByText('—')).not.toBeInTheDocument() }) it('FE-COMP-WEATHERWIDGET-017: clears the error dash when the new anchor comes from cache', async () => { vi.mocked(weatherApi.get).mockRejectedValue(new Error('Network error')) sessionStorage.setItem( 'weather_41.9_12.5_2025-06-01_en', JSON.stringify({ data: buildWeather({ temp: 24 }), fetchedAt: Date.now() }), ) useSettingsStore.setState({ settings: { ...useSettingsStore.getState().settings, temperature_unit: 'celsius' } }) const { rerender } = render() await waitFor(() => { expect(screen.getByText('—')).toBeInTheDocument() }) rerender() await waitFor(() => { expect(screen.getByText('24°C')).toBeInTheDocument() }) expect(weatherApi.get).toHaveBeenCalledTimes(1) }) it('FE-COMP-WEATHERWIDGET-018: the stacked badge shows the icon over the temperature, without a tooltip when it has no place', async () => { vi.mocked(weatherApi.get).mockResolvedValue(buildWeather({ temp: 21 })) useSettingsStore.setState({ settings: { ...useSettingsStore.getState().settings, temperature_unit: 'celsius' } }) const { container } = render() await waitFor(() => { expect(screen.getByText('21°')).toBeInTheDocument() }) expect(container.querySelector('svg')).not.toBeNull() fireEvent.mouseEnter(screen.getByText('21°').parentElement!) await new Promise(r => setTimeout(r, 300)) expect(screen.queryByRole('tooltip')).toBeNull() }) it('FE-COMP-WEATHERWIDGET-019: without its icon the stacked badge names the sky and the place in its tooltip', async () => { vi.mocked(weatherApi.get).mockResolvedValue(buildWeather({ temp: 18, type: 'climate' })) useSettingsStore.setState({ settings: { ...useSettingsStore.getState().settings, temperature_unit: 'celsius' } }) const { container } = render() await waitFor(() => { expect(screen.getByText('Ø18°')).toBeInTheDocument() }) expect(container.querySelector('svg')).toBeNull() fireEvent.mouseEnter(screen.getByText('Ø18°').parentElement!) expect(await screen.findByRole('tooltip')).toHaveTextContent('clear sky, Rome') }) })