// @vitest-environment jsdom import { render, screen, within } from "@testing-library/react"; import { describe, expect, it, vi } from "vitest"; import { createAnonymousSessionAdapter } from "../../src/adapters/auth/external-session-adapter.ts"; import { ROUTE_REGISTRY } from "../../src/features/installed-feature-contracts.ts"; import { ApplicationProvider } from "../../src/presentation/providers/application-provider.tsx"; import { PreferenceProviders } from "../../src/presentation/providers/preference-providers.tsx"; import { AppRouter } from "../../src/presentation/routes/app-router.tsx"; import { createTestApplication } from "../helpers/create-test-application.ts"; import { FIXTURE_FEATURE_ID, FIXTURE_FEATURE_MODULE } from "../helpers/fixture-feature.tsx"; import { createProductFeaturesStub } from "../helpers/runtime-capabilities-stub.ts"; // The test-only feature (tests/helpers/fixture-feature.tsx): the template // installs none. vi.mock("../../src/.generated/product-feature-index.ts", async () => ({ DECLARED_PRODUCT_FEATURE_IDS: ["fixture-feature"], PRODUCT_FEATURE_MODULES: [(await import("../helpers/fixture-feature.tsx")).FIXTURE_FEATURE_MODULE], })); vi.mock("../../src/.generated/product-context-index.ts", async () => ({ PRODUCT_CONTEXT_MODULES: [(await import("../helpers/fixture-feature.tsx")).FIXTURE_CONTEXT_MODULE], })); /** * §3.5. The runtime kill switch, exercised through the running app rather than * through the resolver that computes it. * * Withdrawing a feature from navigation is not the same as taking it out of * service: a typed deep link would still mount it. Both halves are asserted * here, on the same render, so the switch cannot be half-wired. These ran on * the template's reference sample and example screens until they were * deleted (2026-11-07). */ const routes: Readonly> = ROUTE_REGISTRY; // A public page of the feature in the primary navigation, and its menu name. const FEATURE_ROUTE = routes["FIXTURE_FIRST_PAGE"]!; const FEATURE_LINK = (FIXTURE_FEATURE_MODULE.messages["ko-KR"] as Readonly>)[ "route.FIXTURE_FIRST_PAGE.navigation" ]!; function renderAt(path: string, disabled: boolean) { window.history.pushState({}, "", path); return render( , ); } const disabledSurface = () => screen.queryByText( (_, element) => element?.getAttribute("data-disabled-feature") === FIXTURE_FEATURE_ID, ); describe("runtime product feature switch", () => { it("advertises the feature's route while the feature is active", async () => { renderAt("/", false); expect( await screen.findAllByRole("link", { name: FEATURE_LINK }), ).not.toHaveLength(0); }); it("withdraws the feature's route from navigation when it is disabled", async () => { renderAt("/", true); // The shell itself still renders: disabling a feature is not an outage. expect(await screen.findAllByRole("navigation")).not.toHaveLength(0); expect( screen.queryByRole("link", { name: FEATURE_LINK }), ).toBeNull(); }); // 1105/08-03. The home page's starter links read the same switch as the // shell's navigation: switched off at runtime, the feature's screens are // not offered there, and the next active screens take their place. it("leaves the feature's screens out of the home page's starter links when it is disabled", async () => { renderAt("/", true); const starter = await screen.findByRole("region", { name: "준비된 화면 살펴보기" }); const starterPaths = within(starter) .getAllByRole("link") .map((link) => link.getAttribute("href")); const [navigation] = screen.getAllByRole("navigation", { name: "주요 탐색" }); const advertised = within(navigation!) .getAllByRole("link") .map((link) => link.getAttribute("href")) .filter((path) => path !== "/"); expect(starterPaths).not.toContain(FEATURE_ROUTE.path); expect(starterPaths).toEqual(advertised.slice(0, 3)); }); it("offers the feature's screens among the starter links while it is active", async () => { renderAt("/", false); const starter = await screen.findByRole("region", { name: "준비된 화면 살펴보기" }); expect( within(starter) .getAllByRole("link") .map((link) => link.getAttribute("href")), ).toContain(FEATURE_ROUTE.path); }); it("takes the feature out of service for a direct deep link", async () => { renderAt(FEATURE_ROUTE.path, true); expect( await screen.findByText( (_, element) => element?.getAttribute("data-disabled-feature") === FIXTURE_FEATURE_ID, ), ).toBeTruthy(); }); it("serves the same deep link while the feature is active", async () => { renderAt(FEATURE_ROUTE.path, false); expect(await screen.findByRole("heading", { level: 1 })).toBeTruthy(); expect(disabledSurface()).toBeNull(); }); });