v3: src/ gets one layout rule and keeps to it — each layer holds one kind of module, and every layer is split into the same domains — the previous pass sorted components into folders but left hooks, helpers and a barrel inside them, kept hooks/, utils/ and contexts/ flat, and still grouped most tests by theme. The rule: components/ holds only components (.tsx), contexts/ holds FooContext.ts + FooProvider.tsx pairs, hooks/ every hook, utils/ every non-React module, pages/ one component per route and nothing else. Each of components/, contexts/, hooks/ and utils/ is split into the same domains — auth, category, chat, comment, dump, editor, feed, form, layout, player, playlist, profile, social, theme, ws — plus shared/ for what belongs to no one domain, so the chat is components/chat, contexts/chat, hooks/chat and utils/chat. components/ui becomes components/shared to match. Out of components/: useApiForm goes to hooks/form, chat's message.ts and time.ts to utils/chat (with chatDraft and chatText, now draft.ts and text.ts), the emoji skin tone to utils/editor, the remembered volume to utils/player; player/icons.tsx is PlayerIcons.tsx. components/form/index.ts is gone: everything is imported from its own file, FormProvider straight from react-hook-form, and expectOk sits beside friendlyFetchError in utils/shared/api.ts (apiError.ts), since pages that have no form used it too. Out of pages/: the index's feed views, tab bar and presence row move to components/feed; HotFeed and NewFeed, identical but for the sort, are one DumpFeed with an order prop, which also takes over MainFeedProps from pages/index/types.ts. App is a named export like everything else. Tests mirror the tree one file per module — test/<layer>/<domain>/<Module>.test.tsx — so the themed files (hooks/misc, data, editor, sync; utils/misc, text, storage, remote, journal; contexts/providers; pages/auth and UserSubpages; layout/Fabs) are split by subject, the setup each piece needs kept and the rest dropped; the floating-button test becomes one test per button, 627 tests now. The README states the rule. No behaviour changes; the catalogues only move their source references.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

src/test/pages/UserRegister.test.tsx

@@ -0,0 +1,92 @@
+import { describe, expect, test } from "vitest";
+import { screen } from "@testing-library/react";
+import userEvent from "@testing-library/user-event";
+import { Route } from "react-router";
+import { UserRegister } from "../../pages/UserRegister.tsx";
+import { calls, fail, route } from "../fetch.ts";
+import { makeSession, wire } from "../fixtures.ts";
+import { renderWithContexts } from "../render.tsx";
+
+const home = <Route path="/" element={<p>home page</p>} />;
+
+describe("UserRegister", () => {
+  function setup(search = "?token=inv-1") {
+    const user = userEvent.setup();
+    renderWithContexts(<UserRegister />, {
+      route: `/register${search}`,
+      path: "/register",
+      extraRoutes: home,
+    });
+    return user;
+  }
+
+  test("no token: an invalid invite, no request", () => {
+    setup("");
+    expect(screen.getByRole("alert")).toHaveTextContent("Invalid invite");
+    expect(calls("GET /api/invites/:t")).toHaveLength(0);
+  });
+
+  test("an unknown token is invalid", async () => {
+    route("GET /api/invites/:t", () => fail("nope", 404));
+    setup();
+    expect(screen.getByText("Checking invite…")).toBeInTheDocument();
+    expect(await screen.findByRole("alert")).toHaveTextContent("already used");
+  });
+
+  test("registers with a valid invite", async () => {
+    route("GET /api/invites/:t", () => ({}));
+    const session = makeSession({ username: "new_one" });
+    route("POST /api/users/register", () => wire(session));
+    const user = setup();
+    await user.type(await screen.findByPlaceholderText("Username"), "new_one");
+    await user.type(screen.getByPlaceholderText("Email address"), "n@o.pe");
+    await user.type(
+      screen.getByPlaceholderText("Password (min. 8 characters)"),
+      "longenough{Enter}",
+    );
+    await screen.findByText("home page");
+    expect(calls("POST /api/users/register")[0].body).toEqual({
+      username: "new_one",
+      password: "longenough",
+      inviteToken: "inv-1",
+      email: "n@o.pe",
+    });
+    expect(calls("GET /api/invites/:t")[0].params.t).toBe("inv-1");
+  });
+
+  test("validates the username and password length", async () => {
+    route("GET /api/invites/:t", () => ({}));
+    const user = setup();
+    await user.type(
+      await screen.findByPlaceholderText("Username"),
+      "bad name!",
+    );
+    await user.type(screen.getByPlaceholderText("Email address"), "n@o.pe");
+    await user.type(
+      screen.getByPlaceholderText("Password (min. 8 characters)"),
+      "short{Enter}",
+    );
+    expect(await screen.findByText(/letters, numbers, or underscores/))
+      .toBeInTheDocument();
+    expect(screen.getByText("At least 8 characters")).toBeInTheDocument();
+    expect(calls("POST /api/users/register")).toHaveLength(0);
+  });
+
+  test("shows a server refusal (username taken)", async () => {
+    route("GET /api/invites/:t", () => ({}));
+    route(
+      "POST /api/users/register",
+      () => fail("Username already taken", 409),
+    );
+    const user = setup();
+    await user.type(await screen.findByPlaceholderText("Username"), "taken");
+    await user.type(screen.getByPlaceholderText("Email address"), "n@o.pe");
+    await user.type(
+      screen.getByPlaceholderText("Password (min. 8 characters)"),
+      "longenough{Enter}",
+    );
+    expect(await screen.findByRole("alert")).toHaveTextContent(
+      "Username already taken",
+    );
+  });
+});