/* * (c) Copyright 2026 Palantir Technologies Inc. All rights reserved. */ import { render, renderHook, screen } from "@testing-library/react"; import { describe, expect, it, vi } from "@blueprintjs/test-commons/vitest"; import { Classes } from "../../common"; import { Portal } from "../../components/portal/portal"; import type { ThemeAPI } from "../../theme"; import { BlueprintProvider } from "../blueprintProvider"; import { ThemeProvider, type ThemeRepresentations } from "./themeProvider"; import { useBlueprintThemeTokens, useBlueprintThemeValue } from "./useBlueprintTheme"; describe("ThemeProvider", () => { it.each([ undefined, null, [], "theme", {}, { version: "1" }, { version: 2 }, { borderRadius: 8, version: 1 }, { borderRadius: "SQUARE", version: 1 }, { borderRadius: "4em", version: 1 }, { fontFamily: null, version: 1 }, { fontFamily: ["Arial"], version: 1 }, ])("provides no overrides for an invalid representation: %j", representation => { const { result } = renderHook(() => ({ theme: useBlueprintThemeValue(), tokens: useBlueprintThemeTokens() }), { wrapper: ({ children }) => ( {children} ), }); expect(result.current).toEqual({ theme: undefined, tokens: undefined }); }); it("exposes the selected original theme without stripping future fields", () => { const theme = { borderRadius: "8px", futureField: true, version: 1 }; const { result } = renderHook(() => useBlueprintThemeValue(), { wrapper: ({ children }) => {children}, }); expect(result.current).toBe(theme); }); it("uses a defined direct theme without reading the versioned representation", () => { const theme = { borderRadius: "6px", version: 1 } satisfies ThemeAPI; const themesByVersion = { get "1"() { throw new Error("The fallback must not be inspected"); }, }; const { result } = renderHook(() => ({ theme: useBlueprintThemeValue(), tokens: useBlueprintThemeTokens() }), { wrapper: ({ children }) => ( {children} ), }); expect(result.current.theme).toBe(theme); expect(result.current.tokens).toEqual({ "--bp-surface-border-radius": "6px" }); }); it("clears overrides for an invalid direct theme without reading the versioned representation", () => { const theme = { borderRadius: "SQUARE", version: 1 } satisfies ThemeAPI; const themesByVersion = { get "1"() { throw new Error("The versioned theme must not be inspected"); }, }; const { result } = renderHook(() => ({ theme: useBlueprintThemeValue(), tokens: useBlueprintThemeTokens() }), { wrapper: ({ children }) => ( {children} ), }); expect(result.current).toEqual({ theme: undefined, tokens: undefined }); }); it("uses the versioned representation when the direct theme is undefined", () => { const versionedTheme = { borderRadius: "8px", version: 1 }; const { result } = renderHook(() => useBlueprintThemeValue(), { wrapper: ({ children }) => ( {children} ), }); expect(result.current).toBe(versionedTheme); }); it.each([true, false])("accepts isDarkMode=%s without changing current tokens", isDarkMode => { const { result } = renderHook(() => useBlueprintThemeTokens(), { wrapper: ({ children }) => ( {children} ), }); expect(result.current).toEqual({ "--bp-surface-border-radius": "8px" }); }); it("exposes v1 tokens without adding a DOM wrapper or inspecting future versions", () => { const themes = { "1": { borderRadius: "8px", fontFamily: "Arial", futureField: true, version: 1 }, get "2"() { throw new Error("Future schemas must not be inspected"); }, }; function Consumer() { const tokens = useBlueprintThemeTokens(); return
; } const { container } = render( , ); const root = screen.getByTestId("root"); expect(container.firstElementChild).toBe(root); expect(root.style.getPropertyValue("--bp-surface-border-radius")).toBe("8px"); expect(root.style.getPropertyValue("--bp-typography-family-default")).toBe("Arial"); }); it("updates and clears portal overrides without remounting children or styling the container", () => { const mounted = vi.fn(); const view = (themes?: ThemeRepresentations) => ( ); const { rerender } = render(view({ "1": { borderRadius: "8px", fontFamily: "Arial", version: 1 } })); const input = screen.getByRole("textbox"); const root = input.parentElement!; expect(root.style.getPropertyValue("--bp-surface-border-radius")).toBe("8px"); expect(root).toHaveClass(Classes.THEME_ROOT); expect(root.style.getPropertyValue("--bp-typography-family-default")).toBe("Arial"); expect(document.body.style.getPropertyValue("--bp-surface-border-radius")).toBe(""); root.style.setProperty("--unrelated", "keep"); rerender(view({ "1": { borderRadius: "0px", version: 1 } })); expect(screen.getByRole("textbox")).toBe(input); expect(root.style.getPropertyValue("--bp-surface-border-radius")).toBe("0px"); expect(root.style.getPropertyValue("--bp-typography-family-default")).toBe(""); for (const themes of [ { "1": { borderRadius: "SQUARE", version: 1 } }, { "1": { borderRadius: 8, version: 1 } }, { "2": { version: 2 } }, undefined, ]) { rerender(view(themes)); expect(root.style.getPropertyValue("--bp-surface-border-radius")).toBe(""); expect(root.style.getPropertyValue("--unrelated")).toBe("keep"); } expect(mounted).toHaveBeenCalledOnce(); }); it("accepts and clears a directly authored theme through BlueprintProvider", () => { const theme: ThemeAPI = { borderRadius: "4.5px", version: 1 }; const view = (value?: ThemeAPI) => ( Direct theme ); const { rerender } = render(view(theme)); const root = screen.getByText("Direct theme").parentElement!; expect(root.style.getPropertyValue("--bp-surface-border-radius")).toBe("4.5px"); rerender(view()); expect(root.style.getPropertyValue("--bp-surface-border-radius")).toBe(""); }); });