import { afterEach, describe, expect, it, vi } from "vitest"; import { SETTINGS_TARGET_ATTRIBUTE, SETTINGS_TARGET_HIGHLIGHT_ATTRIBUTE, createSettingsTargetRegistry, revealSettingsTarget, settingsTargetFromHash, settingsTargetSelector, } from "./target"; afterEach(() => { document.body.innerHTML = ""; vi.useRealTimers(); vi.restoreAllMocks(); }); describe("settings target identity", () => { it("decodes valid fragments and ignores empty or malformed fragments", () => { expect(settingsTargetFromHash("#setting-terminal-font-size")).toBe( "setting-terminal-font-size", ); expect(settingsTargetFromHash("#setting%3Aterminal")).toBe("setting:terminal"); expect(settingsTargetFromHash("")).toBeNull(); expect(settingsTargetFromHash("#")).toBeNull(); expect(settingsTargetFromHash("#%E0%A4%A")).toBeNull(); }); it("escapes target ids used in DOM selectors", () => { expect(settingsTargetSelector("setting:terminal")).toBe( `[${SETTINGS_TARGET_ATTRIBUTE}="setting\\:terminal"]`, ); }); }); describe("settings target registry", () => { it("reveals a target already registered", () => { const reveal = vi.fn(); const registry = createSettingsTargetRegistry(reveal); const target = document.createElement("div"); registry.register("font-size", target); expect(registry.request("font-size")).toBe(true); expect(reveal).toHaveBeenCalledWith(target); }); it("keeps a missing request pending until asynchronous content registers", () => { const reveal = vi.fn(); const registry = createSettingsTargetRegistry(reveal); const target = document.createElement("div"); expect(registry.request("late-control")).toBe(false); registry.register("late-control", target); expect(reveal).toHaveBeenCalledWith(target); }); it("re-reveals a target when the same fragment is requested twice", () => { const reveal = vi.fn(); const registry = createSettingsTargetRegistry(reveal); const target = document.createElement("div"); registry.register("font-size", target); registry.request("font-size"); registry.request("font-size"); expect(reveal).toHaveBeenCalledTimes(2); }); }); describe("revealSettingsTarget", () => { it("centers, focuses the first control, then removes its one-shot highlight", () => { vi.useFakeTimers(); const target = document.createElement("div"); const input = document.createElement("input"); target.appendChild(input); target.scrollIntoView = vi.fn(); document.body.appendChild(target); revealSettingsTarget(target, { highlightDurationMs: 900, reducedMotion: false }); expect(target.scrollIntoView).toHaveBeenCalledWith({ behavior: "smooth", block: "center" }); expect(document.activeElement).toBe(input); expect(target.getAttribute(SETTINGS_TARGET_HIGHLIGHT_ATTRIBUTE)).toBe("true"); vi.advanceTimersByTime(900); expect(target.hasAttribute(SETTINGS_TARGET_HIGHLIGHT_ATTRIBUTE)).toBe(false); }); it("honors an explicit focus marker and reduced motion", () => { const target = document.createElement("div"); const first = document.createElement("button"); const marked = document.createElement("button"); marked.setAttribute("data-settings-target-focus", ""); target.append(first, marked); target.scrollIntoView = vi.fn(); document.body.appendChild(target); revealSettingsTarget(target, { reducedMotion: true }); expect(target.scrollIntoView).toHaveBeenCalledWith({ behavior: "auto", block: "center" }); expect(document.activeElement).toBe(marked); }); });