Self-hosted, Self-Improving, Federated Everything App — dev management, agent orchestration, persistent mind, digital twin, second brain, and creative pipeline from a single dashboard over Tailscale to port the user into the OS
JavaScript ai-agentsdashboarddeveloper-toolsdigital-twinquantified-selfsecond-brainself-hostedtailscale
import { describe, it, expect, vi, afterEach } from 'vitest';
import { renderHook, fireEvent } from '@testing-library/react';
import { useRef } from 'react';
import useClickOutside from './useClickOutside';
afterEach(() => {
vi.restoreAllMocks();
document.body.innerHTML = '';
});
// Mount an inside element attached to the ref and an outside sibling, so a
// mousedown on either lands inside vs outside the ref'd element.
function setupDom() {
const inside = document.createElement('div');
const outside = document.createElement('div');
document.body.append(inside, outside);
return { inside, outside };
}
describe('useClickOutside', () => {
it('fires onOutside for a mousedown outside the ref, not inside it', () => {
const { inside, outside } = setupDom();
const onOutside = vi.fn();
renderHook(() => {
const ref = useRef(inside);
useClickOutside(ref, true, onOutside);
});
fireEvent.mouseDown(inside);
expect(onOutside).not.toHaveBeenCalled();
fireEvent.mouseDown(outside);
expect(onOutside).toHaveBeenCalledTimes(1);
});
it('does not bind while inactive', () => {
const { outside } = setupDom();
const onOutside = vi.fn();
renderHook(() => {
const ref = useRef(document.createElement('div'));
useClickOutside(ref, false, onOutside);
});
fireEvent.mouseDown(outside);
expect(onOutside).not.toHaveBeenCalled();
});
it('calls the latest onOutside without re-subscribing when the handler identity changes', () => {
const { inside, outside } = setupDom();
const first = vi.fn();
const second = vi.fn();
const addSpy = vi.spyOn(window, 'addEventListener');
const { rerender } = renderHook(
({ fn }) => {
const ref = useRef(inside);
useClickOutside(ref, true, fn);
},
{ initialProps: { fn: first } },
);
const subs = addSpy.mock.calls.filter(([type]) => type === 'mousedown').length;
rerender({ fn: second });
fireEvent.mouseDown(outside);
expect(first).not.toHaveBeenCalled();
expect(second).toHaveBeenCalledTimes(1);
expect(addSpy.mock.calls.filter(([type]) => type === 'mousedown').length).toBe(subs);
});
// The array form exists for portaled popovers: the panel renders into <body>,
// so it is not inside the trigger's subtree and a single-ref check would treat
// every click on the panel as an outside click and close it.
describe('multiple refs', () => {
it('treats a click in any of the refs as inside', () => {
const { inside: trigger, outside } = setupDom();
const panel = document.createElement('div');
document.body.append(panel);
const onOutside = vi.fn();
renderHook(() => {
const triggerRef = useRef(trigger);
const panelRef = useRef(panel);
useClickOutside([triggerRef, panelRef], true, onOutside);
});
fireEvent.mouseDown(trigger);
fireEvent.mouseDown(panel);
expect(onOutside).not.toHaveBeenCalled();
fireEvent.mouseDown(outside);
expect(onOutside).toHaveBeenCalledTimes(1);
});
it('tolerates a ref that has not attached yet', () => {
const { inside: trigger, outside } = setupDom();
const onOutside = vi.fn();
renderHook(() => {
const triggerRef = useRef(trigger);
const unattachedRef = useRef(null);
useClickOutside([triggerRef, unattachedRef], true, onOutside);
});
fireEvent.mouseDown(outside);
expect(onOutside).toHaveBeenCalledTimes(1);
});
it('does not resubscribe when the caller passes a fresh array literal each render', () => {
const { inside: trigger } = setupDom();
const panel = document.createElement('div');
document.body.append(panel);
const addSpy = vi.spyOn(window, 'addEventListener');
const { rerender } = renderHook(() => {
const triggerRef = useRef(trigger);
const panelRef = useRef(panel);
// A new array every render — the common call-site shape.
useClickOutside([triggerRef, panelRef], true, vi.fn());
});
const subs = addSpy.mock.calls.filter(([type]) => type === 'mousedown').length;
rerender();
rerender();
expect(addSpy.mock.calls.filter(([type]) => type === 'mousedown').length).toBe(subs);
});
});
it('detaches the listener on unmount', () => {
const { outside } = setupDom();
const onOutside = vi.fn();
const { unmount } = renderHook(() => {
const ref = useRef(document.createElement('div'));
useClickOutside(ref, true, onOutside);
});
unmount();
fireEvent.mouseDown(outside);
expect(onOutside).not.toHaveBeenCalled();
});
});