// FE-COMP-APPEARANCE-001+ — color mode moved here from DisplaySettingsTab, // plus the new scheme / readability / dashboard-widget controls. import { render, screen, waitFor, fireEvent } from '../../../tests/helpers/render'; import userEvent from '@testing-library/user-event'; import { http, HttpResponse } from 'msw'; import { server } from '../../../tests/helpers/msw/server'; import { useAuthStore } from '../../store/authStore'; import { useSettingsStore } from '../../store/settingsStore'; import { resetAllStores, seedStore } from '../../../tests/helpers/store'; import { buildUser, buildSettings } from '../../../tests/helpers/factories'; import { ToastContainer } from '../shared/Toast'; import AppearanceSettingsTab from './AppearanceSettingsTab'; beforeEach(() => { resetAllStores(); server.use(http.put('/api/settings', async () => HttpResponse.json({ success: true }))); seedStore(useAuthStore, { user: buildUser(), isAuthenticated: true }); seedStore(useSettingsStore, { settings: buildSettings({ dark_mode: 'light', language: 'en' }) }); }); describe('AppearanceSettingsTab', () => { it('FE-COMP-APPEARANCE-001: renders without crashing', () => { render(); expect(document.body).toBeInTheDocument(); }); it('FE-COMP-APPEARANCE-002: shows the color-mode buttons', () => { render(); expect(screen.getByText('Light')).toBeInTheDocument(); expect(screen.getByText('Dark')).toBeInTheDocument(); expect(screen.getByRole('button', { name: /Auto/i })).toBeInTheDocument(); }); it('FE-COMP-APPEARANCE-003: clicking Dark calls updateSetting with dark', async () => { const user = userEvent.setup(); const updateSetting = vi.fn().mockResolvedValue(undefined); seedStore(useSettingsStore, { settings: buildSettings({ dark_mode: 'light' }), updateSetting }); render(); await user.click(screen.getByText('Dark')); expect(updateSetting).toHaveBeenCalledWith('dark_mode', 'dark'); }); it('FE-COMP-APPEARANCE-004: clicking Light calls updateSetting with light', async () => { const user = userEvent.setup(); const updateSetting = vi.fn().mockResolvedValue(undefined); seedStore(useSettingsStore, { settings: buildSettings({ dark_mode: 'dark' }), updateSetting }); render(); await user.click(screen.getByText('Light')); expect(updateSetting).toHaveBeenCalledWith('dark_mode', 'light'); }); it('FE-COMP-APPEARANCE-005: clicking Auto calls updateSetting with auto', async () => { const user = userEvent.setup(); const updateSetting = vi.fn().mockResolvedValue(undefined); seedStore(useSettingsStore, { settings: buildSettings({ dark_mode: 'light' }), updateSetting }); render(); await user.click(screen.getByRole('button', { name: /Auto/i })); expect(updateSetting).toHaveBeenCalledWith('dark_mode', 'auto'); }); it('FE-COMP-APPEARANCE-006: shows readability + dashboard widget sections', () => { render(); expect(screen.getByText('Readability')).toBeInTheDocument(); expect(screen.getByText('Transparency')).toBeInTheDocument(); expect(screen.getByText('Dashboard widgets')).toBeInTheDocument(); }); it('FE-COMP-APPEARANCE-007: shows the preset color schemes', () => { render(); expect(screen.getByText('Indigo')).toBeInTheDocument(); expect(screen.getByText('Teal')).toBeInTheDocument(); expect(screen.getByText('High contrast')).toBeInTheDocument(); }); it('FE-COMP-APPEARANCE-008: choosing a scheme persists the appearance config', async () => { const user = userEvent.setup(); const updateSetting = vi.fn().mockResolvedValue(undefined); seedStore(useSettingsStore, { settings: buildSettings({ dark_mode: 'light' }), updateSetting }); render(); await user.click(screen.getByText('Indigo')); await waitFor( () => expect(updateSetting).toHaveBeenCalledWith('appearance', expect.objectContaining({ schemeId: 'indigo' })), { timeout: 1500 }, ); }); it('FE-COMP-APPEARANCE-009: toggling transparency persists transparency:false', async () => { const user = userEvent.setup(); const updateSetting = vi.fn().mockResolvedValue(undefined); seedStore(useSettingsStore, { settings: buildSettings({ dark_mode: 'light' }), updateSetting }); render(); await user.click(screen.getByRole('button', { name: 'Transparency' })); await waitFor( () => expect(updateSetting).toHaveBeenCalledWith('appearance', expect.objectContaining({ transparency: false })), { timeout: 1500 }, ); }); }); // ── Custom accent, sliders, widgets and error paths (010–021) ───────────────── const PERSIST = { timeout: 1500 } as const; function seedAppearance(updateSetting = vi.fn().mockResolvedValue(undefined)) { seedStore(useSettingsStore, { settings: buildSettings({ dark_mode: 'light', language: 'en' }), updateSetting }); return updateSetting; } /** The last `appearance` payload the debounced persist wrote. */ function lastAppearance(updateSetting: ReturnType): Record { const calls = updateSetting.mock.calls.filter(c => c[0] === 'appearance'); return calls[calls.length - 1][1] as Record; } describe('AppearanceSettingsTab – custom accent and sliders', () => { it('FE-COMP-APPEARANCE-010: a failing persist surfaces the error toast', async () => { const user = userEvent.setup(); seedAppearance(vi.fn().mockRejectedValue(new Error('Appearance rejected'))); render(<>); await user.click(screen.getByText('Teal')); expect(await screen.findByText('Appearance rejected', undefined, PERSIST)).toBeInTheDocument(); }); it('FE-COMP-APPEARANCE-011: a failing colour-mode change surfaces the error toast', async () => { const user = userEvent.setup(); seedAppearance(vi.fn().mockRejectedValue(new Error('Mode rejected'))); render(<>); await user.click(screen.getByText('Dark')); expect(await screen.findByText('Mode rejected')).toBeInTheDocument(); }); it('FE-COMP-APPEARANCE-012: picking Custom reveals the accent picker', async () => { const user = userEvent.setup(); const updateSetting = seedAppearance(); render(); expect(screen.queryByText('Custom accent')).not.toBeInTheDocument(); await user.click(screen.getByText('Custom')); expect(screen.getByText('Custom accent')).toBeInTheDocument(); await waitFor( () => expect(updateSetting).toHaveBeenCalledWith('appearance', expect.objectContaining({ schemeId: 'custom' })), PERSIST, ); }); it('FE-COMP-APPEARANCE-013: an accent preset sets both the light and the dark accent', async () => { const user = userEvent.setup(); const updateSetting = seedAppearance(); render(); await user.click(screen.getByText('Custom')); await user.click(screen.getByRole('button', { name: '#0d9488' })); await waitFor( () => expect(lastAppearance(updateSetting).accent).toEqual({ light: '#0d9488', dark: '#0d9488' }), PERSIST, ); }); it('FE-COMP-APPEARANCE-014: the two colour inputs edit the light and dark accent separately', async () => { const user = userEvent.setup(); const updateSetting = seedAppearance(); render(); await user.click(screen.getByText('Custom')); const [light, dark] = Array.from(document.querySelectorAll('input[type="color"]')) as HTMLInputElement[]; fireEvent.change(light, { target: { value: '#112233' } }); await waitFor(() => expect(lastAppearance(updateSetting).accent).toMatchObject({ light: '#112233' }), PERSIST); fireEvent.change(dark, { target: { value: '#445566' } }); await waitFor(() => expect(lastAppearance(updateSetting).accent).toEqual({ light: '#112233', dark: '#445566' }), PERSIST); }); it('FE-COMP-APPEARANCE-015: the contrast hint follows the picked accent', async () => { const user = userEvent.setup(); seedAppearance(); render(); await user.click(screen.getByText('Custom')); expect(screen.getByText(/Good contrast/)).toBeInTheDocument(); // Near-white on white is unreadable — the hint has to say so. fireEvent.change(document.querySelectorAll('input[type="color"]')[0], { target: { value: '#fafafa' } }); expect(screen.getByText(/Low contrast/)).toBeInTheDocument(); }); it('FE-COMP-APPEARANCE-016: reduce motion is persisted', async () => { const user = userEvent.setup(); const updateSetting = seedAppearance(); render(); await user.click(screen.getByRole('button', { name: 'Reduce motion' })); await waitFor( () => expect(updateSetting).toHaveBeenCalledWith('appearance', expect.objectContaining({ reduceMotion: true })), PERSIST, ); }); it('FE-COMP-APPEARANCE-017: the global text-size slider persists fontScale', async () => { const updateSetting = seedAppearance(); render(); fireEvent.change(screen.getAllByRole('slider')[0], { target: { value: '1.2' } }); await waitFor(() => expect(lastAppearance(updateSetting).fontScale).toBe(1.2), PERSIST); expect(screen.getAllByText('120%').length).toBeGreaterThan(0); }); it('FE-COMP-APPEARANCE-018: each size row writes its own typeScale entry', async () => { const updateSetting = seedAppearance(); render(); const sliders = screen.getAllByRole('slider'); fireEvent.change(sliders[1], { target: { value: '1.15' } }); fireEvent.change(sliders[2], { target: { value: '1.1' } }); fireEvent.change(sliders[3], { target: { value: '0.9' } }); fireEvent.change(sliders[4], { target: { value: '0.85' } }); await waitFor( () => expect(lastAppearance(updateSetting).typeScale).toMatchObject({ title: 1.15, subtitle: 1.1, body: 0.9, caption: 0.85, }), PERSIST, ); }); }); describe('AppearanceSettingsTab – dashboard widgets', () => { it('FE-COMP-APPEARANCE-019: toggling a desktop widget persists it under dashboard.desktop', async () => { const user = userEvent.setup(); const updateSetting = seedAppearance(); render(); await user.click(screen.getByRole('button', { name: 'Atlas / countries' })); await waitFor( () => expect(lastAppearance(updateSetting).dashboard).toMatchObject({ desktop: { atlas: false } }), PERSIST, ); }); it('FE-COMP-APPEARANCE-020: turning the sidebar master off disables its child widgets', async () => { const user = userEvent.setup(); const updateSetting = seedAppearance(); render(); const master = screen.getByRole('button', { name: 'Right sidebar' }); expect(master).toHaveAttribute('aria-pressed', 'true'); await user.click(master); await waitFor( () => expect(lastAppearance(updateSetting).dashboard).toMatchObject({ desktop: { sidebar: false } }), PERSIST, ); expect(screen.getByRole('button', { name: 'Right sidebar' })).toHaveAttribute('aria-pressed', 'false'); }); it('FE-COMP-APPEARANCE-021: toggling a mobile widget only touches the mobile map', async () => { const user = userEvent.setup(); const updateSetting = seedAppearance(); render(); // Currency exists on both devices; the second occurrence is the mobile row. const currencyToggles = screen.getAllByRole('button', { name: 'Currency' }); await user.click(currencyToggles[1]); await waitFor( () => expect(lastAppearance(updateSetting).dashboard).toMatchObject({ desktop: { currency: true }, mobile: { currency: false }, }), PERSIST, ); }); it('FE-COMP-APPEARANCE-022: Reset to defaults writes the whole default config back', async () => { const user = userEvent.setup(); const updateSetting = seedAppearance(); render(); await user.click(screen.getByRole('button', { name: 'Atlas / countries' })); await waitFor(() => expect(lastAppearance(updateSetting).dashboard).toMatchObject({ desktop: { atlas: false } }), PERSIST); await user.click(screen.getByRole('button', { name: /Reset to defaults/ })); await waitFor( () => expect(lastAppearance(updateSetting).dashboard).toMatchObject({ desktop: { atlas: true } }), PERSIST, ); }); // The scheme is already on the DOM by then, so dropping the write would revert the // choice on the next load without ever telling the user. it('FE-COMP-APPEARANCE-023: leaving the tab before the debounce fires flushes the pending save once', async () => { const user = userEvent.setup(); const updateSetting = seedAppearance(); const { unmount } = render(); await user.click(screen.getByText('Indigo')); unmount(); const calls = updateSetting.mock.calls.filter(c => c[0] === 'appearance'); expect(calls).toHaveLength(1); expect(calls[0][1]).toMatchObject({ schemeId: 'indigo' }); // The timer is cancelled, so nothing lands a second time. await new Promise(resolve => setTimeout(resolve, 500)); expect(updateSetting.mock.calls.filter(c => c[0] === 'appearance')).toHaveLength(1); }); it('FE-COMP-APPEARANCE-024: a debounce that already fired is not written again on unmount', async () => { const user = userEvent.setup(); const updateSetting = seedAppearance(); const { unmount } = render(); await user.click(screen.getByText('Teal')); await waitFor(() => expect(updateSetting.mock.calls.filter(c => c[0] === 'appearance')).toHaveLength(1), PERSIST); unmount(); expect(updateSetting.mock.calls.filter(c => c[0] === 'appearance')).toHaveLength(1); }); });