Your lightweight open-source personal agent.
Python agent-frameworkai-agentai-agentschatbotchatopsdiscord-botllm-agentsllmslocal-llmmcpmodel-context-protocolmulti-agentopenai-compatibleopenclawpersonal-ai-assistantpythonself-hostedtelegram-bot-ai-assistantwebuiworkflow-automation
import { act, cleanup, renderHook } from "@testing-library/react";
import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
import { useTheme } from "@/hooks/useTheme";
describe("useTheme", () => {
let systemDark = false;
let mediaEvents: EventTarget;
let restoreNativeTransition: (() => void) | undefined;
function deferNativeCapture() {
const previous = Object.getOwnPropertyDescriptor(document, "startViewTransition");
let update!: () => void;
let ready!: () => void;
let finish!: () => void;
const transition = {
ready: new Promise<void>(resolve => { ready = resolve; }),
finished: new Promise<void>(resolve => { finish = resolve; }),
skipTransition: vi.fn(),
};
const start = vi.fn((callback: () => void) => { update = callback; return transition; });
Object.defineProperty(document, "startViewTransition", { configurable: true, value: start });
restoreNativeTransition = () => {
if (previous) Object.defineProperty(document, "startViewTransition", previous);
else Reflect.deleteProperty(document, "startViewTransition");
};
return { start, capture: () => { update(); ready(); }, finish };
}
function changeSystemTheme(dark: boolean) {
act(() => {
systemDark = dark;
mediaEvents.dispatchEvent(new Event("change"));
});
}
function notifyStorageChange(key: string | null = "nanobot-webui.theme") {
act(() => window.dispatchEvent(new StorageEvent("storage", { key })));
}
beforeEach(() => {
vi.useFakeTimers();
systemDark = false;
mediaEvents = new EventTarget();
vi.stubGlobal("matchMedia", vi.fn((query: string) => ({
get matches() { return query === "(prefers-color-scheme: dark)" && systemDark; },
addEventListener: mediaEvents.addEventListener.bind(mediaEvents),
removeEventListener: mediaEvents.removeEventListener.bind(mediaEvents),
})));
localStorage.removeItem("nanobot-webui.theme");
document.documentElement.classList.remove("dark");
const themeColor = document.createElement("meta");
themeColor.name = "theme-color";
themeColor.content = "#ffffff";
themeColor.dataset.themeColorLight = "#ffffff";
themeColor.dataset.themeColorDark = "#303030";
document.head.append(themeColor);
});
afterEach(() => {
cleanup();
restoreNativeTransition?.();
restoreNativeTransition = undefined;
vi.clearAllTimers();
vi.useRealTimers();
vi.restoreAllMocks();
vi.unstubAllGlobals();
delete document.documentElement.dataset.themeTransition;
document.querySelector('meta[name="theme-color"]')?.remove();
document.documentElement.classList.remove("dark");
localStorage.removeItem("nanobot-webui.theme");
});
it("keeps browser chrome in sync with the selected app theme", () => {
localStorage.setItem("nanobot-webui.theme", "dark");
const { result } = renderHook(useTheme);
const themeColor = document.querySelector<HTMLMetaElement>('meta[name="theme-color"]');
expect(document.documentElement).toHaveClass("dark");
expect(themeColor?.content).toBe("#303030");
act(() => result.current.setTheme("light"));
expect(document.documentElement).not.toHaveClass("dark");
expect(themeColor?.content).toBe("#ffffff");
expect(localStorage.getItem("nanobot-webui.theme")).toBe("light");
expect(result.current.preference).toBe("light");
});
it.each(["light", "dark"] as const)("preserves a previously saved %s choice", (saved) => {
systemDark = saved === "light";
localStorage.setItem("nanobot-webui.theme", saved);
const { result } = renderHook(useTheme);
expect(result.current.preference).toBe(saved);
expect(result.current.theme).toBe(saved);
expect(localStorage.getItem("nanobot-webui.theme")).toBe(saved);
});
it("defaults to system and follows live changes without persisting the resolved theme", () => {
const { result } = renderHook(useTheme);
const themeColor = document.querySelector<HTMLMetaElement>('meta[name="theme-color"]');
expect(result.current.preference).toBe("system");
expect(result.current.theme).toBe("light");
changeSystemTheme(true);
expect(result.current.preference).toBe("system");
expect(result.current.theme).toBe("dark");
expect(document.documentElement).toHaveClass("dark");
expect(themeColor?.content).toBe("#303030");
changeSystemTheme(false);
expect(result.current.theme).toBe("light");
expect(document.documentElement).not.toHaveClass("dark");
expect(themeColor?.content).toBe("#ffffff");
expect(localStorage.getItem("nanobot-webui.theme")).toBeNull();
});
it("restores system preference against the current system theme", () => {
localStorage.setItem("nanobot-webui.theme", "system");
systemDark = true;
const { result } = renderHook(useTheme);
expect(result.current.preference).toBe("system");
expect(result.current.theme).toBe("dark");
changeSystemTheme(false);
expect(result.current.theme).toBe("light");
expect(localStorage.getItem("nanobot-webui.theme")).toBe("system");
});
it("ignores system changes in explicit mode and resumes the latest system theme", () => {
const { result } = renderHook(useTheme);
act(() => result.current.setTheme("light"));
changeSystemTheme(true);
expect(result.current.preference).toBe("light");
expect(result.current.theme).toBe("light");
expect(document.documentElement).not.toHaveClass("dark");
act(() => result.current.setTheme("system"));
expect(result.current.preference).toBe("system");
expect(result.current.theme).toBe("dark");
expect(document.documentElement).toHaveClass("dark");
expect(localStorage.getItem("nanobot-webui.theme")).toBe("system");
});
it.each([false, true])("toggles the resolved system theme into an explicit choice: dark=%s", (dark) => {
systemDark = dark;
const { result } = renderHook(useTheme);
const selected = dark ? "light" : "dark";
act(() => result.current.toggle());
expect(result.current.preference).toBe(selected);
expect(result.current.theme).toBe(selected);
expect(localStorage.getItem("nanobot-webui.theme")).toBe(selected);
changeSystemTheme(!dark);
changeSystemTheme(dark);
expect(result.current.theme).toBe(selected);
act(() => vi.advanceTimersByTime(600));
act(() => result.current.toggle());
expect(result.current.preference).toBe(dark ? "dark" : "light");
expect(result.current.theme).toBe(dark ? "dark" : "light");
});
it("synchronizes other tabs and storage removal without writing back", () => {
const { result } = renderHook(useTheme);
const write = vi.spyOn(Storage.prototype, "setItem");
localStorage.setItem("nanobot-webui.theme", "dark");
write.mockClear();
notifyStorageChange("nanobot.locale");
expect(result.current.preference).toBe("system");
notifyStorageChange();
expect(result.current.preference).toBe("dark");
expect(result.current.theme).toBe("dark");
expect(document.documentElement).toHaveClass("dark");
expect(write).not.toHaveBeenCalled();
localStorage.removeItem("nanobot-webui.theme");
notifyStorageChange();
expect(result.current.preference).toBe("system");
expect(result.current.theme).toBe("light");
localStorage.setItem("nanobot-webui.theme", "dark");
notifyStorageChange();
localStorage.clear();
write.mockClear();
notifyStorageChange(null);
expect(result.current.preference).toBe("system");
expect(result.current.theme).toBe("light");
expect(write).not.toHaveBeenCalled();
});
it("uses system for unrecognized stored preferences", () => {
systemDark = true;
localStorage.setItem("nanobot-webui.theme", "invalid");
const { result } = renderHook(useTheme);
expect(result.current.preference).toBe("system");
expect(result.current.theme).toBe("dark");
});
it("keeps theme controls usable when browser storage is unavailable", () => {
vi.spyOn(Storage.prototype, "getItem").mockImplementation(() => { throw new Error("Storage blocked"); });
vi.spyOn(Storage.prototype, "setItem").mockImplementation(() => { throw new Error("Storage blocked"); });
const { result } = renderHook(useTheme);
expect(result.current.preference).toBe("system");
act(() => result.current.setTheme("dark"));
expect(result.current.preference).toBe("dark");
expect(result.current.theme).toBe("dark");
expect(document.documentElement).toHaveClass("dark");
});
it("can select system during a same-palette transition and still follows OS changes", () => {
systemDark = true;
localStorage.setItem("nanobot-webui.theme", "light");
const { result } = renderHook(useTheme);
act(() => result.current.setTheme("dark"));
expect(document.documentElement).toHaveAttribute("data-theme-transition", "dark");
act(() => result.current.setTheme("system"));
expect(result.current.preference).toBe("system");
expect(result.current.theme).toBe("dark");
expect(localStorage.getItem("nanobot-webui.theme")).toBe("system");
changeSystemTheme(false);
expect(result.current.theme).toBe("light");
expect(localStorage.getItem("nanobot-webui.theme")).toBe("system");
act(() => vi.advanceTimersByTime(600));
expect(document.documentElement).not.toHaveAttribute("data-theme-transition");
expect(result.current.theme).toBe("light");
});
it("retains a same-palette System choice before a native capture commits", async () => {
systemDark = true;
localStorage.setItem("nanobot-webui.theme", "light");
const native = deferNativeCapture();
const { result } = renderHook(useTheme);
act(() => result.current.setTheme("dark"));
expect(native.start).toHaveBeenCalledOnce();
expect(localStorage.getItem("nanobot-webui.theme")).toBe("dark");
act(() => result.current.setTheme("light"));
expect(localStorage.getItem("nanobot-webui.theme")).toBe("dark");
act(() => result.current.setTheme("system"));
expect(localStorage.getItem("nanobot-webui.theme")).toBe("system");
act(() => native.capture());
expect(result.current.preference).toBe("system");
expect(result.current.theme).toBe("dark");
changeSystemTheme(false);
expect(result.current.theme).toBe("light");
expect(localStorage.getItem("nanobot-webui.theme")).toBe("system");
await act(async () => native.finish());
act(() => vi.advanceTimersByTime(600));
expect(document.documentElement).not.toHaveAttribute("data-theme-snapshot");
expect(document.documentElement).not.toHaveAttribute("data-theme-transition");
});
it("keeps another tab's newer preference when a native capture is pending", async () => {
localStorage.setItem("nanobot-webui.theme", "light");
const native = deferNativeCapture();
const { result } = renderHook(useTheme);
act(() => result.current.setTheme("dark"));
const write = vi.spyOn(Storage.prototype, "setItem");
localStorage.removeItem("nanobot-webui.theme");
notifyStorageChange();
act(() => native.capture());
expect(result.current.preference).toBe("system");
expect(result.current.theme).toBe("light");
expect(document.documentElement).not.toHaveClass("dark");
expect(write).not.toHaveBeenCalled();
await act(async () => native.finish());
act(() => vi.advanceTimersByTime(600));
expect(document.documentElement).not.toHaveAttribute("data-theme-snapshot");
});
it("ignores rapid reversals for 600ms without replaying them later", () => {
localStorage.setItem("nanobot-webui.theme", "light");
const { result } = renderHook(useTheme);
expect(document.documentElement).not.toHaveAttribute("data-theme-transition");
act(() => result.current.toggle());
expect(result.current.theme).toBe("dark");
expect(document.documentElement).toHaveAttribute("data-theme-transition", "dark");
act(() => {
result.current.toggle();
result.current.setTheme("light");
vi.advanceTimersByTime(599);
});
act(() => result.current.toggle());
expect(result.current.theme).toBe("dark");
expect(localStorage.getItem("nanobot-webui.theme")).toBe("dark");
act(() => vi.advanceTimersByTime(1));
expect(document.documentElement).not.toHaveAttribute("data-theme-transition");
act(() => vi.advanceTimersByTime(600));
expect(result.current.theme).toBe("dark");
act(() => result.current.toggle());
expect(result.current.theme).toBe("light");
expect(localStorage.getItem("nanobot-webui.theme")).toBe("light");
});
it("releases the temporary transition styles when its owner unmounts", () => {
const { result, unmount } = renderHook(useTheme);
act(() => result.current.toggle());
expect(document.documentElement).toHaveAttribute("data-theme-transition");
unmount();
expect(document.documentElement).not.toHaveAttribute("data-theme-transition");
expect(vi.getTimerCount()).toBe(0);
});
});