// @vitest-environment jsdom import { render, screen, waitFor } from "@testing-library/react"; import userEvent from "@testing-library/user-event"; import { useState } from "react"; import { createMemoryRouter, RouterProvider, useNavigate } from "react-router-dom"; import { z } from "zod"; import { describe, expect, it, vi } from "vitest"; import { createFailure } from "../../src/contracts/errors.ts"; import { Button } from "../../src/presentation/components/ui/button.ts"; import { DirtyNavigationDialog, ErrorSummary, Form, FormFailureStatus, FormField, useAppForm, useDirtyNavigationGuard, } from "../../src/presentation/forms/index.ts"; type Values = Readonly>; const schema = z .object({ name: z.string().trim().min(2), note: z.string().trim().default(""), }) .strict(); const defaults: Values = { name: "", note: "" }; function FormHarness(props: Readonly<{ submit(command: Readonly<{ name: string; note?: string }>): Promise< | Readonly<{ ok: true; value: string }> | Readonly<{ ok: false; error: ReturnType }> >; resetOnSuccess?: boolean; onFailureAction?(): void; }>) { const form = useAppForm({ schema, defaultValues: defaults, allowedServerFields: ["name", "note"], mapToCommand(values) { return { name: values.name, ...(values.note ? { note: values.note } : {}), }; }, submit: props.submit, resetOnSuccess: props.resetOnSuccess, }); return (
void form.submitForm(event)}> void form.submitForm() : props.onFailureAction } /> {String(form.dirty)} {form.result} ); } describe("local form facade", () => { it("focuses the first invalid field and performs no command", async () => { const user = userEvent.setup(); const submit = vi.fn(); render(); await user.click(screen.getByRole("button", { name: "Submit" })); expect(submit).not.toHaveBeenCalled(); expect(screen.getByRole("textbox", { name: /Name/ })).toHaveFocus(); expect(screen.getByRole("alert")).toHaveTextContent("Name"); }); it("submits transformed data once and clears dirty state after success", async () => { const user = userEvent.setup(); let finish: ((value: { ok: true; value: string }) => void) | undefined; const submit = vi.fn( () => new Promise<{ ok: true; value: string }>((resolve) => { finish = resolve; }), ); render(); await user.type(screen.getByRole("textbox", { name: /Name/ }), " Ready "); await user.type(screen.getByRole("textbox", { name: "Note" }), " Safe "); await user.dblClick(screen.getByRole("button", { name: "Submit" })); await waitFor(() => expect(submit).toHaveBeenCalledOnce()); expect(submit).toHaveBeenCalledWith({ name: "Ready", note: "Safe" }); expect(screen.getByRole("button", { name: "Pending" })).toBeDisabled(); finish?.({ ok: true, value: "saved" }); await waitFor(() => expect(screen.getByTestId("dirty")).toHaveTextContent("false")); expect(screen.getByTestId("result")).toHaveTextContent("success"); }); it("maps only approved 422 fields and never renders backend copy", async () => { const user = userEvent.setup(); const failure = createFailure( "VALIDATION_REJECTED", "CREATE_ENTITY", 0, { validationIssues: [ { path: "name", code: "REQUIRED" }, { path: "serverOnly", code: "raw-secret-message" }, ], }, ); render( ({ ok: false, error: failure })} />, ); await user.type(screen.getByRole("textbox", { name: /Name/ }), "Valid"); await user.click(screen.getByRole("button", { name: "Submit" })); expect(await screen.findByRole("alert")).toHaveTextContent("필수 입력값입니다."); expect(screen.getByRole("alert")).toHaveTextContent( "서버가 확인하지 못한 입력 항목", ); expect(document.body).not.toHaveTextContent("raw-secret-message"); }); it.each([ [ "AUTH_REQUIRED", "reauth-required", "계속하려면 로그인이 필요합니다.", "로그인", ], [ "FORBIDDEN", "forbidden", "이 작업을 수행할 권한이 없습니다.", "안전한 화면으로 이동", ], [ "RATE_LIMITED", "retry-later", "요청이 많습니다. 잠시 후 다시 시도해 주세요.", "다시 시도", ], ] as const)( "shows %s as its own save state, not an input error", async (kind, result, copy, action) => { const user = userEvent.setup(); const onFailureAction = vi.fn(); const submit = vi.fn(async () => ({ ok: false as const, error: createFailure(kind, "CREATE_ENTITY", 0, { effect: "NOT_APPLIED", }), })); render( , ); await user.type(screen.getByRole("textbox", { name: /Name/ }), "Valid"); await user.click(screen.getByRole("button", { name: "Submit" })); expect(await screen.findByTestId("result")).toHaveTextContent(result); expect(screen.getByRole("alert")).toHaveTextContent(copy); expect(document.body).not.toHaveTextContent("입력 내용을 확인해 주세요."); expect(document.body).not.toHaveTextContent("저장하지 못했습니다."); expect( document.body.textContent?.includes("입력한 내용은 사라집니다"), ).toBe(kind === "AUTH_REQUIRED"); expect(screen.getByRole("textbox", { name: /Name/ })).toHaveValue("Valid"); await user.click(screen.getByRole("button", { name: action })); if (kind === "RATE_LIMITED") { expect(submit).toHaveBeenCalledTimes(2); expect(onFailureAction).not.toHaveBeenCalled(); } else { expect(onFailureAction).toHaveBeenCalledOnce(); } }, ); // F-10 (08-01). A save that failed for a reason the user cannot fix in the // input is a status with its own action, never an input error summary. it.each([ ["NOT_FOUND", "요청한 항목을 찾을 수 없습니다.", "안전한 화면으로 이동"], ["UNKNOWN_CLIENT_FAILURE", "요청을 처리할 수 없습니다.", "지원 정보 확인"], ] as const)( "shows an unavailable %s save as a status, not an input error", async (kind, copy, action) => { const user = userEvent.setup(); const onFailureAction = vi.fn(); render( ({ ok: false, error: createFailure(kind, "CREATE_ENTITY", 0, { effect: "NOT_APPLIED", }), })} onFailureAction={onFailureAction} />, ); await user.type(screen.getByRole("textbox", { name: /Name/ }), "Valid"); await user.click(screen.getByRole("button", { name: "Submit" })); expect(await screen.findByTestId("result")).toHaveTextContent( "unavailable", ); expect(screen.getByRole("alert")).toHaveTextContent(copy); expect(document.body).not.toHaveTextContent("입력 내용을 확인해 주세요."); await user.click(screen.getByRole("button", { name: action })); expect(onFailureAction).toHaveBeenCalledOnce(); }, ); it("keeps conflict input out of URL and storage", async () => { const user = userEvent.setup(); localStorage.clear(); window.history.replaceState({}, "", "/form-test"); render( ({ ok: false, error: createFailure("CONFLICT", "CREATE_ENTITY", 0), })} />, ); const secretLike = "token-like-do-not-copy"; await user.type(screen.getByRole("textbox", { name: /Name/ }), secretLike); await user.click(screen.getByRole("button", { name: "Submit" })); expect(await screen.findByText(/다른 변경과 충돌했습니다/)).toBeVisible(); expect(screen.getByRole("textbox", { name: /Name/ })).toHaveValue(secretLike); expect(window.location.href).not.toContain(secretLike); expect(JSON.stringify(localStorage)).not.toContain(secretLike); }); it("blocks a second submit while the prior effect remains unknown", async () => { const user = userEvent.setup(); const submit = vi.fn(async () => ({ ok: false as const, error: createFailure("SERVER_FAILURE", "CREATE_ENTITY", 0, { effect: "MAYBE_APPLIED", }), })); render(); const name = screen.getByRole("textbox", { name: /Name/ }); await user.type(name, "Alpha"); await user.click(screen.getByRole("button", { name: "Submit" })); expect(await screen.findByTestId("result")).toHaveTextContent( "effect-unknown", ); await user.clear(name); await user.type(name, "Beta"); await user.click(screen.getByRole("button", { name: "Submit" })); expect(submit).toHaveBeenCalledOnce(); expect(screen.getByTestId("result")).toHaveTextContent("effect-unknown"); }); it("settles the submitted unknown snapshot without accepting later edits", async () => { const user = userEvent.setup(); const submit = vi.fn(async () => ({ ok: false as const, error: createFailure("SERVER_FAILURE", "CREATE_ENTITY", 0, { effect: "MAYBE_APPLIED", }), })); render(); const name = screen.getByRole("textbox", { name: /Name/ }); await user.type(name, "Alpha"); await user.click(screen.getByRole("button", { name: "Submit" })); await screen.findByText("effect-unknown"); await user.clear(name); await user.type(name, "Beta"); await user.click(screen.getByRole("button", { name: "Confirm applied" })); expect(name).toHaveValue("Beta"); expect(screen.getByTestId("result")).toHaveTextContent("success"); expect(screen.getByTestId("dirty")).toHaveTextContent("true"); await user.clear(name); await user.type(name, "Alpha"); expect(screen.getByTestId("dirty")).toHaveTextContent("false"); }); it("releases an unknown submission only after explicit not-applied settlement", async () => { const user = userEvent.setup(); const submit = vi .fn() .mockResolvedValueOnce({ ok: false as const, error: createFailure("SERVER_FAILURE", "CREATE_ENTITY", 0, { effect: "MAYBE_APPLIED", }), }) .mockResolvedValueOnce({ ok: true as const, value: "saved" }); render(); await user.type(screen.getByRole("textbox", { name: /Name/ }), "Alpha"); await user.click(screen.getByRole("button", { name: "Submit" })); await screen.findByText("effect-unknown"); await user.click( screen.getByRole("button", { name: "Confirm not applied" }), ); expect(screen.getByTestId("result")).toHaveTextContent("idle"); await user.click(screen.getByRole("button", { name: "Submit" })); expect(submit).toHaveBeenCalledTimes(2); }); }); describe("dirty navigation guard", () => { it("blocks navigation, restores focus on stay and proceeds explicitly", async () => { const user = userEvent.setup(); function GuardedPage() { const navigate = useNavigate(); const [dirty, setDirty] = useState(false); const guard = useDirtyNavigationGuard(dirty); return ( <> setDirty(true)} /> ); } const router = createMemoryRouter( [ { path: "/", element: }, { path: "/target", element:

Target

}, ], { initialEntries: ["/"] }, ); render(); await user.type(screen.getByRole("textbox", { name: "Guard field" }), "x"); const leave = screen.getByRole("button", { name: "Leave" }); await user.click(leave); expect( screen.getByRole("dialog", { name: "저장하지 않은 변경이 있습니다." }), ).toHaveAttribute("open"); await user.click(screen.getByRole("button", { name: "계속 작성" })); await waitFor(() => expect(leave).toHaveFocus()); await user.click(leave); await user.click(screen.getByRole("button", { name: "변경 버리고 이동" })); expect(await screen.findByRole("heading", { name: "Target" })).toBeVisible(); }); }); describe("submission timing", () => { it("submits once when a second submit arrives during async validation", async () => { const user = userEvent.setup(); let releaseValidation: () => void = () => {}; const validationGate = new Promise((resolve) => { releaseValidation = resolve; }); const asyncSchema = schema.refine(async () => { await validationGate; return true; }); const submit = vi.fn(async () => ({ ok: true as const, value: "saved" })); function AsyncForm() { const form = useAppForm({ schema: asyncSchema, defaultValues: defaults, allowedServerFields: ["name", "note"], mapToCommand: (values) => ({ name: values.name }), submit, }); return (
void form.submitForm(event)}> {form.result} ); } render(); await user.type(screen.getByRole("textbox", { name: /Name/ }), "Ready"); await user.click(screen.getByRole("button", { name: "Submit" })); await user.click(screen.getByRole("button", { name: "Submit" })); releaseValidation(); await waitFor(() => expect(screen.getByTestId("result")).toHaveTextContent("success"), ); expect(submit).toHaveBeenCalledOnce(); }); it("does not ask to discard changes when navigating right after a save", async () => { const user = userEvent.setup(); function SaveThenLeave() { const navigate = useNavigate(); const form = useAppForm({ schema, defaultValues: defaults, allowedServerFields: ["name", "note"], mapToCommand: (values) => ({ name: values.name }), submit: async () => ({ ok: true as const, value: "saved" }), }); const guard = useDirtyNavigationGuard(form.dirty); return (
{ void form.submitForm(event).then((outcome) => { if (outcome?.ok) void navigate("/done"); }); }} pending={form.pending} > ); } const router = createMemoryRouter( [ { path: "/", element: }, { path: "/done", element:

Done

}, ], { initialEntries: ["/"] }, ); render(); await user.type(screen.getByRole("textbox", { name: /Name/ }), "Ready"); await user.click(screen.getByRole("button", { name: "Save" })); expect(await screen.findByRole("heading", { name: "Done" })).toBeVisible(); expect( screen.queryByRole("dialog", { name: "저장하지 않은 변경이 있습니다." }), ).not.toBeInTheDocument(); }); });