import { fireEvent, render, screen, within } from '@testing-library/react';
import userEvent from '@testing-library/user-event';
import type { ReactNode } from 'react';
import { MemoryRouter } from 'react-router';
import { beforeEach, describe, expect, it, vi } from 'vitest';
import { buildSetupProgress, type SetupFlags } from '@/lib/setup-progress';
// The Overview setup stepper: every step is browsable. Clicking a step (its
// circle or anywhere on its row) or pressing Enter/Space on it selects it and
// shows it in the Spotlight panel. Hover never changes the panel; it only
// rings the circle as a cue. The default selection is the current step.
const NOTHING_DONE: SetupFlags = {
email: false,
oauth: false,
analytics: false,
payments: false,
deployed: false,
billingOptOut: false,
};
const mutate = vi.fn();
let flags: SetupFlags = NOTHING_DONE;
vi.mock('@/hooks/api/useSetupStatus', () => ({
useSetupStatus: () => ({
progress: buildSetupProgress(flags),
isLoading: false,
isError: false,
setBillingOptOut: { mutate, isPending: false },
}),
}));
vi.mock('@/hooks/api', () => ({
useDocsVisibility: () => ({ userDocsEnabled: true, apiDocsEnabled: true, isLoading: false }),
}));
const { SetupProgress } = await import('@/components/admin/SetupProgress');
function renderStepper(next: SetupFlags = NOTHING_DONE) {
flags = next;
const wrapper = ({ children }: { children: ReactNode }) => {children};
return render(, { wrapper });
}
const stepButton = (label: RegExp) => screen.getByRole('button', { name: label });
const spotlight = () => screen.getByRole('complementary');
const eyebrow = () => screen.getByTestId('spotlight-eyebrow');
const rowOf = (label: RegExp) => stepButton(label).parentElement as HTMLElement;
describe('SetupProgress stepper', () => {
beforeEach(() => mutate.mockReset());
it('defaults to the current step with a "Next up" header', () => {
renderStepper();
expect(eyebrow()).toHaveTextContent('Next up · Step 3 of 7');
expect(within(spotlight()).getByRole('heading', { name: 'Email' })).toBeInTheDocument();
const email = stepButton(/Email/);
expect(email).toHaveAttribute('aria-pressed', 'true');
expect(email).toHaveAttribute('aria-current', 'step');
expect(stepButton(/Payments/)).toHaveAttribute('aria-pressed', 'false');
});
it('does not change the spotlight on hover, only on click', async () => {
const user = userEvent.setup();
renderStepper();
await user.hover(stepButton(/Payments/));
fireEvent.mouseEnter(rowOf(/Payments/));
fireEvent.mouseOver(rowOf(/Payments/));
expect(eyebrow()).toHaveTextContent('Next up · Step 3 of 7');
expect(within(spotlight()).getByRole('heading', { name: 'Email' })).toBeInTheDocument();
expect(stepButton(/Payments/)).toHaveAttribute('aria-pressed', 'false');
await user.click(stepButton(/Payments/));
expect(eyebrow()).toHaveTextContent(/^Step 6 of 7$/);
expect(within(spotlight()).getByRole('heading', { name: 'Payments' })).toBeInTheDocument();
});
it('selects a step on click and keeps it after the pointer leaves', async () => {
const user = userEvent.setup();
renderStepper();
await user.click(stepButton(/Analytics/));
await user.unhover(stepButton(/Analytics/));
expect(stepButton(/Analytics/)).toHaveAttribute('aria-pressed', 'true');
expect(stepButton(/Email/)).toHaveAttribute('aria-pressed', 'false');
expect(eyebrow()).toHaveTextContent(/^Step 5 of 7$/);
// Integrations reset to the step's own list, first option picked.
expect(within(spotlight()).getByRole('radio', { name: /Plausible/ })).toBeChecked();
});
it('selects a step from the keyboard with Enter and Space', async () => {
const user = userEvent.setup();
renderStepper();
stepButton(/Social logins/).focus();
await user.keyboard('{Enter}');
expect(eyebrow()).toHaveTextContent(/^Step 4 of 7$/);
expect(stepButton(/Social logins/)).toHaveAttribute('aria-pressed', 'true');
stepButton(/Deploy/).focus();
await user.keyboard(' ');
expect(eyebrow()).toHaveTextContent(/^Step 7 of 7$/);
});
// jsdom has no layout or pseudo-element hit-testing, so the whole-row click
// target is pinned by its contract: the step button's ::after overlay is
// stretched over the positioned row, and only the copy button is lifted
// above it. (Verified in Chromium: hovering or clicking the command area,
// the description and the circle all land on the step button.)
it('stretches the step button over the whole row, below only the copy button', async () => {
const user = userEvent.setup();
renderStepper();
const button = stepButton(/Analytics/);
const row = rowOf(/Analytics/);
expect(row.className).toMatch(/\brelative\b/);
expect(button.className).toContain('after:absolute');
expect(button.className).toContain('after:inset-0');
// Normal arrow cursor, no row or button background.
expect(button.className).toContain('cursor-default');
expect(button.className).not.toContain('cursor-pointer');
expect(button.className).not.toMatch(/(^|\s)([a-z-]+:)*bg-/);
expect(button.className).not.toMatch(/(^|\s)relative(\s|$)/);
// No row highlight: state lives on the circle.
expect(row.className).not.toMatch(/bg-/);
const copy = within(row).getByRole('button', { name: /vibecarbon configure analytics/ });
expect(copy.className).toContain('relative');
expect(copy.className).toContain('z-30');
// Copy stays a copy: it does not select the step.
await user.click(copy);
expect(button).toHaveAttribute('aria-pressed', 'false');
// Clicking the row's text (inside the stretched control) selects it.
await user.click(within(row).getByText('Privacy-friendly usage insights'));
expect(button).toHaveAttribute('aria-pressed', 'true');
});
it('shows hover and selection on the step circle', async () => {
const user = userEvent.setup();
renderStepper();
const circle = (label: RegExp) => stepButton(label).firstElementChild as HTMLElement;
// Default: the current step (Email) is selected.
expect(circle(/Email/)).toHaveAttribute('data-selected');
expect(circle(/Payments/)).not.toHaveAttribute('data-selected');
// Hover is a CSS cue on the circle, driven by hovering the step button
// (its overlay spans the row): a faint ring, never a state change.
expect(stepButton(/Payments/).className).toContain('group/step');
expect(circle(/Payments/).className).toContain('group-hover/step:ring-primary/45');
await user.click(stepButton(/Payments/));
expect(circle(/Payments/)).toHaveAttribute('data-selected');
// Selected wins over hover, at full strength.
expect(circle(/Payments/).className).not.toContain('group-hover/step:ring');
expect(circle(/Payments/).className).toMatch(/(^|\s)ring-primary(\s|$)/);
expect(circle(/Email/)).not.toHaveAttribute('data-selected');
// The current step keeps its glow whether or not it is selected.
expect(circle(/Email/).className).toContain('shadow-[0_0_0_4px_var(--glow-primary)]');
});
it('shows a done header with the command and integrations still browsable', async () => {
const user = userEvent.setup();
renderStepper({ ...NOTHING_DONE, email: true });
await user.click(stepButton(/Email/));
expect(eyebrow()).toHaveTextContent('✓ Done · Step 3 of 7');
expect(within(spotlight()).getAllByRole('radio')).toHaveLength(4);
expect(within(spotlight()).getByText('vibecarbon configure email resend')).toBeInTheDocument();
});
it('offers "Skip payments" only on the payments step', async () => {
const user = userEvent.setup();
renderStepper();
expect(screen.queryByRole('button', { name: /Skip payments/ })).not.toBeInTheDocument();
await user.click(stepButton(/Payments/));
await user.click(screen.getByRole('button', { name: /Skip payments/ }));
expect(mutate).toHaveBeenCalledWith(true);
});
it('keeps the panel when every step is complete, defaulting to deploy', async () => {
const user = userEvent.setup();
renderStepper({
email: true,
oauth: true,
analytics: true,
payments: false,
deployed: true,
billingOptOut: true,
});
expect(eyebrow()).toHaveTextContent('✓ Done · Step 7 of 7');
await user.click(stepButton(/Payments/));
expect(eyebrow()).toHaveTextContent('Skipped · Step 6 of 7');
expect(screen.queryByRole('button', { name: /Skip payments/ })).not.toBeInTheDocument();
});
});