@musecat/functionkit 1.0.2 → 1.2.0

package/tests/hooks/useIntersectionObserver.test.ts

@@ -1,13 +0,0 @@
-import { describe, test, expect, vi } from "vitest";
-import { renderHook } from "@testing-library/react";
-import { useIntersectionObserver } from "@/packages/hooks/useIntersectionObserver";
-
-describe("useIntersectionObserver", () => {
-	test("returns a ref callback", () => {
-		const callback = vi.fn();
-		const { result } = renderHook(() =>
-			useIntersectionObserver(callback, { threshold: 0 }),
-		);
-		expect(typeof result.current).toBe("function");
-	});
-});

package/tests/hooks/useInterval.test.ts

@@ -1,31 +0,0 @@
-import { describe, test, expect, vi, beforeEach, afterEach } from "vitest";
-import { renderHook } from "@testing-library/react";
-import { useInterval } from "@/packages/hooks/useInterval";
-
-describe("useInterval", () => {
-	beforeEach(() => { vi.useFakeTimers(); });
-	afterEach(() => { vi.useRealTimers(); });
-
-	test("calls callback repeatedly at interval", () => {
-		const fn = vi.fn();
-		renderHook(() => useInterval(fn, 100));
-		expect(fn).not.toHaveBeenCalled();
-		vi.advanceTimersByTime(100);
-		expect(fn).toHaveBeenCalledTimes(1);
-		vi.advanceTimersByTime(100);
-		expect(fn).toHaveBeenCalledTimes(2);
-	});
-
-	test("calls immediately with immediate option", () => {
-		const fn = vi.fn();
-		renderHook(() => useInterval(fn, { delay: 100, immediate: true }));
-		expect(fn).toHaveBeenCalledOnce();
-	});
-
-	test("does not call when disabled", () => {
-		const fn = vi.fn();
-		renderHook(() => useInterval(fn, { delay: 100, enabled: false }));
-		vi.advanceTimersByTime(200);
-		expect(fn).not.toHaveBeenCalled();
-	});
-});

package/tests/hooks/useKeyboardHeight.test.ts

@@ -1,10 +0,0 @@
-import { describe, test, expect } from "vitest";
-import { renderHook } from "@testing-library/react";
-import { useKeyboardHeight } from "@/packages/hooks/useKeyboardHeight";
-
-describe("useKeyboardHeight", () => {
-	test("returns default keyboard height of 0", () => {
-		const { result } = renderHook(() => useKeyboardHeight());
-		expect(result.current.keyboardHeight).toBe(0);
-	});
-});

package/tests/hooks/useKeyboardListNavigation.test.ts

@@ -1,82 +0,0 @@
-import { describe, test, expect, vi } from "vitest";
-import { renderHook, act } from "@testing-library/react";
-import { useKeyboardListNavigation } from "@/packages/hooks/useKeyboardListNavigation";
-
-describe("useKeyboardListNavigation", () => {
-	test("initializes with activeIndex -1", () => {
-		const { result } = renderHook(() =>
-			useKeyboardListNavigation({ itemCount: 3 }),
-		);
-		expect(result.current.activeIndex).toBe(-1);
-	});
-
-	test("handleListKeyDown with ArrowDown moves to first item when none active", () => {
-		const { result } = renderHook(() =>
-			useKeyboardListNavigation({ itemCount: 3 }),
-		);
-
-		const container = document.createElement("div");
-		const items = [0, 1, 2].map(() => {
-			const el = document.createElement("div");
-			el.setAttribute("tabindex", "-1");
-			el.scrollIntoView = vi.fn();
-			container.appendChild(el);
-			return el;
-		});
-		items.forEach((el, i) => result.current.setItemRef(i, el));
-
-		const event = {
-			key: "ArrowDown",
-			defaultPrevented: false,
-			preventDefault: vi.fn(),
-			target: container,
-		} as unknown as React.KeyboardEvent<HTMLElement>;
-
-		act(() => { result.current.handleListKeyDown(event); });
-		expect(result.current.activeIndex).toBe(0);
-	});
-
-	test("handleListKeyDown with ArrowUp moves to previous item", () => {
-		const { result } = renderHook(() =>
-			useKeyboardListNavigation({ itemCount: 3 }),
-		);
-
-		const container = document.createElement("div");
-		const items = [0, 1, 2].map(() => {
-			const el = document.createElement("div");
-			el.setAttribute("tabindex", "-1");
-			el.scrollIntoView = vi.fn();
-			container.appendChild(el);
-			return el;
-		});
-		items.forEach((el, i) => result.current.setItemRef(i, el));
-		act(() => { result.current.setActiveIndex(1); });
-
-		const event = {
-			key: "ArrowUp",
-			defaultPrevented: false,
-			preventDefault: vi.fn(),
-			target: container,
-		} as unknown as React.KeyboardEvent<HTMLElement>;
-
-		act(() => { result.current.handleListKeyDown(event); });
-		expect(result.current.activeIndex).toBe(0);
-	});
-
-	test("Escape resets activeIndex to -1", () => {
-		const { result } = renderHook(() =>
-			useKeyboardListNavigation({ itemCount: 3 }),
-		);
-
-		const event = {
-			key: "Escape",
-			defaultPrevented: false,
-			preventDefault: vi.fn(),
-			target: document.createElement("div"),
-		} as unknown as React.KeyboardEvent<HTMLElement>;
-
-		result.current.setActiveIndex(1);
-		act(() => { result.current.handleListKeyDown(event); });
-		expect(result.current.activeIndex).toBe(-1);
-	});
-});

package/tests/hooks/useLongPress.test.ts

@@ -1,52 +0,0 @@
-import { describe, test, expect, vi, beforeEach, afterEach } from "vitest";
-import { renderHook, act } from "@testing-library/react";
-import type React from "react";
-import { useLongPress } from "@/packages/hooks/useLongPress";
-
-function createMouseEvent(type: string): React.MouseEvent<HTMLElement> {
-	return {
-		type,
-		nativeEvent: new MouseEvent(type, { clientX: 0, clientY: 0 }),
-		clientX: 0,
-		clientY: 0,
-	} as unknown as React.MouseEvent<HTMLElement>;
-}
-
-describe("useLongPress", () => {
-	beforeEach(() => { vi.useFakeTimers(); });
-	afterEach(() => { vi.useRealTimers(); });
-
-	test("fires onLongPress after delay", () => {
-		const onLongPress = vi.fn();
-		const { result } = renderHook(() => useLongPress(onLongPress, { delay: 200 }));
-
-		act(() => { result.current.onMouseDown(createMouseEvent("mousedown")); });
-		expect(onLongPress).not.toHaveBeenCalled();
-		vi.advanceTimersByTime(200);
-		expect(onLongPress).toHaveBeenCalledOnce();
-	});
-
-	test("fires onClick when released before delay", () => {
-		const onLongPress = vi.fn();
-		const onClick = vi.fn();
-		const { result } = renderHook(() =>
-			useLongPress(onLongPress, { delay: 200, onClick }),
-		);
-
-		act(() => { result.current.onMouseDown(createMouseEvent("mousedown")); });
-		act(() => { result.current.onMouseUp(createMouseEvent("mouseup")); });
-		vi.advanceTimersByTime(200);
-		expect(onLongPress).not.toHaveBeenCalled();
-		expect(onClick).toHaveBeenCalledOnce();
-	});
-
-	test("cancels on mouse leave", () => {
-		const onLongPress = vi.fn();
-		const { result } = renderHook(() => useLongPress(onLongPress, { delay: 200 }));
-
-		act(() => { result.current.onMouseDown(createMouseEvent("mousedown")); });
-		act(() => { result.current.onMouseLeave(createMouseEvent("mouseleave")); });
-		vi.advanceTimersByTime(200);
-		expect(onLongPress).not.toHaveBeenCalled();
-	});
-});

package/tests/hooks/usePreservedCallback.test.ts

@@ -1,35 +0,0 @@
-import { describe, test, expect, vi } from "vitest";
-import { renderHook } from "@testing-library/react";
-import { usePreservedCallback } from "@/packages/hooks/usePreservedCallback";
-
-describe("usePreservedCallback", () => {
-	test("returns a stable function reference across renders", () => {
-		const { result, rerender } = renderHook(
-			({ cb }) => usePreservedCallback(cb),
-			{ initialProps: { cb: vi.fn() } },
-		);
-		const firstRef = result.current;
-		rerender({ cb: vi.fn() });
-		expect(result.current).toBe(firstRef);
-	});
-
-	test("invokes the latest callback", () => {
-		const fn1 = vi.fn();
-		const fn2 = vi.fn();
-		const { result, rerender } = renderHook(
-			({ cb }) => usePreservedCallback(cb),
-			{ initialProps: { cb: fn1 } },
-		);
-		rerender({ cb: fn2 });
-		result.current();
-		expect(fn2).toHaveBeenCalledOnce();
-		expect(fn1).not.toHaveBeenCalled();
-	});
-
-	test("passes arguments through", () => {
-		const fn = vi.fn();
-		const { result } = renderHook(() => usePreservedCallback(fn));
-		result.current("a", 1);
-		expect(fn).toHaveBeenCalledWith("a", 1);
-	});
-});

package/tests/hooks/usePreservedReference.test.ts

@@ -1,35 +0,0 @@
-import { describe, test, expect, vi } from "vitest";
-import { renderHook } from "@testing-library/react";
-import { usePreservedReference } from "@/packages/hooks/usePreservedReference";
-
-describe("usePreservedReference", () => {
-	test("returns same reference for deeply equal values", () => {
-		const { result, rerender } = renderHook(
-			({ val }) => usePreservedReference(val),
-			{ initialProps: { val: { a: 1, b: { c: [2, 3] } } } },
-		);
-		const first = result.current;
-		rerender({ val: { a: 1, b: { c: [2, 3] } } });
-		expect(result.current).toBe(first);
-	});
-
-	test("returns new reference for different values", () => {
-		const { result, rerender } = renderHook(
-			({ val }) => usePreservedReference(val),
-			{ initialProps: { val: { a: 1 } } },
-		);
-		const first = result.current;
-		rerender({ val: { a: 2 } });
-		expect(result.current).not.toBe(first);
-	});
-
-	test("accepts custom comparator", () => {
-		const { result, rerender } = renderHook(
-			({ val }) => usePreservedReference(val, () => true),
-			{ initialProps: { val: { a: 1 } } },
-		);
-		const first = result.current;
-		rerender({ val: { a: 999 } });
-		expect(result.current).toBe(first);
-	});
-});

package/tests/hooks/useRefEffect.test.ts

@@ -1,30 +0,0 @@
-import { describe, test, expect, vi } from "vitest";
-import { renderHook, act } from "@testing-library/react";
-import { useRefEffect } from "@/packages/hooks/useRefEffect";
-
-describe("useRefEffect", () => {
-	test("calls callback with element and cleanup on unmount", () => {
-		const cleanup = vi.fn();
-		const callback = vi.fn(() => cleanup);
-		const { result } = renderHook(() => useRefEffect(callback, []));
-
-		const element = document.createElement("div");
-		act(() => { (result.current as (el: HTMLElement | null) => void)(element); });
-		expect(callback).toHaveBeenCalledWith(element);
-
-		act(() => { (result.current as (el: HTMLElement | null) => void)(null); });
-		expect(cleanup).toHaveBeenCalledOnce();
-	});
-
-	test("calls cleanup before setting new element", () => {
-		const cleanup = vi.fn();
-		const callback = vi.fn(() => cleanup);
-		const { result } = renderHook(() => useRefEffect(callback, []));
-
-		const el1 = document.createElement("div");
-		const el2 = document.createElement("span");
-		act(() => { (result.current as (el: HTMLElement | null) => void)(el1); });
-		act(() => { (result.current as (el: HTMLElement | null) => void)(el2); });
-		expect(cleanup).toHaveBeenCalledOnce();
-	});
-});

package/tests/hooks/useRelativeDateTime.test.ts

@@ -1,19 +0,0 @@
-import { describe, test, expect, vi, beforeEach, afterEach } from "vitest";
-import { renderHook } from "@testing-library/react";
-import { useRelativeDateTime } from "@/packages/hooks/useRelativeDateTime";
-
-describe("useRelativeDateTime", () => {
-	beforeEach(() => { vi.useFakeTimers(); });
-	afterEach(() => { vi.useRealTimers(); });
-
-	test("returns relative time text", () => {
-		const now = Date.now();
-		const fiveMinAgo = new Date(now - 5 * 60 * 1000).toISOString();
-		const { result } = renderHook(() =>
-			useRelativeDateTime(fiveMinAgo, { locale: "ko" }),
-		);
-		expect(result.current.ready).toBe(true);
-		expect(result.current.isRelative).toBe(true);
-		expect(result.current.text).toBeTruthy();
-	});
-});

package/tests/hooks/useTimeout.test.ts

@@ -1,34 +0,0 @@
-import { describe, test, expect, vi, beforeEach, afterEach } from "vitest";
-import { renderHook, act } from "@testing-library/react";
-import { useTimeout } from "@/packages/hooks/useTimeout";
-
-describe("useTimeout", () => {
-	beforeEach(() => { vi.useFakeTimers(); });
-	afterEach(() => { vi.useRealTimers(); });
-
-	test("calls callback after delay", () => {
-		const fn = vi.fn();
-		renderHook(() => useTimeout(fn, 100));
-		expect(fn).not.toHaveBeenCalled();
-		vi.advanceTimersByTime(100);
-		expect(fn).toHaveBeenCalledOnce();
-	});
-
-	test("does not call when disabled", () => {
-		const fn = vi.fn();
-		renderHook(() => useTimeout(fn, 100, { enabled: false }));
-		vi.advanceTimersByTime(200);
-		expect(fn).not.toHaveBeenCalled();
-	});
-
-	test("start and clear controls", () => {
-		const fn = vi.fn();
-		const { result } = renderHook(() => useTimeout(fn, 1000, { enabled: false }));
-		expect(result.current.isPending()).toBe(false);
-		act(() => { result.current.start(50); });
-		expect(result.current.isPending()).toBe(true);
-		vi.advanceTimersByTime(50);
-		expect(fn).toHaveBeenCalledOnce();
-		expect(result.current.isPending()).toBe(false);
-	});
-});

package/tests/hooks/useToggleState.test.ts

@@ -1,35 +0,0 @@
-import { describe, test, expect } from "vitest";
-import { renderHook, act } from "@testing-library/react";
-import { useToggleState } from "@/packages/hooks/useToggleState";
-
-describe("useToggleState", () => {
-	test("initializes with false by default", () => {
-		const { result } = renderHook(() => useToggleState());
-		expect(result.current.value).toBe(false);
-	});
-
-	test("initializes with provided value", () => {
-		const { result } = renderHook(() => useToggleState(true));
-		expect(result.current.value).toBe(true);
-	});
-
-	test("setTrue sets value to true", () => {
-		const { result } = renderHook(() => useToggleState(false));
-		act(() => { result.current.setTrue(); });
-		expect(result.current.value).toBe(true);
-	});
-
-	test("setFalse sets value to false", () => {
-		const { result } = renderHook(() => useToggleState(true));
-		act(() => { result.current.setFalse(); });
-		expect(result.current.value).toBe(false);
-	});
-
-	test("toggle switches value", () => {
-		const { result } = renderHook(() => useToggleState(false));
-		act(() => { result.current.toggle(); });
-		expect(result.current.value).toBe(true);
-		act(() => { result.current.toggle(); });
-		expect(result.current.value).toBe(false);
-	});
-});

package/tests/hooks/useViewportHeight.test.ts

@@ -1,10 +0,0 @@
-import { describe, test, expect } from "vitest";
-import { renderHook } from "@testing-library/react";
-import { useViewportHeight } from "@/packages/hooks/useViewportHeight";
-
-describe("useViewportHeight", () => {
-	test("returns a height value", () => {
-		const { result } = renderHook(() => useViewportHeight());
-		expect(result.current.height).toBeGreaterThanOrEqual(0);
-	});
-});

package/tests/hooks/useViewportMatch.test.ts

@@ -1,35 +0,0 @@
-import { describe, test, expect, vi, beforeEach } from "vitest";
-import { renderHook } from "@testing-library/react";
-import { useViewportMatch } from "@/packages/hooks/useViewportMatch";
-
-describe("useViewportMatch", () => {
-	beforeEach(() => {
-		vi.stubGlobal(
-			"matchMedia",
-			vi.fn().mockImplementation((query: string) => ({
-				matches: false,
-				media: query,
-				addEventListener: vi.fn(),
-				removeEventListener: vi.fn(),
-			})),
-		);
-	});
-
-	test("returns false initially", () => {
-		const { result } = renderHook(() => useViewportMatch("(min-width: 768px)"));
-		expect(result.current).toBe(false);
-	});
-
-	test("returns true when matched", () => {
-		vi.stubGlobal(
-			"matchMedia",
-			vi.fn().mockImplementation(() => ({
-				matches: true,
-				addEventListener: vi.fn(),
-				removeEventListener: vi.fn(),
-			})),
-		);
-		const { result } = renderHook(() => useViewportMatch("(min-width: 768px)"));
-		expect(result.current).toBe(true);
-	});
-});

package/tests/setup.ts

@@ -1,9 +0,0 @@
-import "@testing-library/jest-dom";
-
-class ResizeObserverMock {
-	observe() {}
-	unobserve() {}
-	disconnect() {}
-}
-
-window.ResizeObserver = ResizeObserverMock as unknown as typeof ResizeObserver;

package/tests/utils/browserStorage.test.ts

@@ -1,54 +0,0 @@
-import { describe, test, expect, vi, beforeEach, afterEach } from "vitest";
-import {
-	getLocalStorage,
-	updateLocalStorage,
-	removeLocalStorage,
-	getSessionStorage,
-	updateSessionStorage,
-	removeSessionStorage,
-} from "@/packages/utils/browserStorage";
-
-describe("browserStorage", () => {
-	let mockStorage: Record<string, string>;
-	let mockStorage2: Record<string, string>;
-
-	beforeEach(() => {
-		mockStorage = {};
-		mockStorage2 = {};
-
-		const createMockStorage = (store: Record<string, string>) => ({
-			getItem: vi.fn((key) => store[key] ?? null),
-			setItem: vi.fn((key, value) => { store[key] = value.toString(); }),
-			removeItem: vi.fn((key) => { delete store[key]; }),
-			clear: vi.fn(() => { Object.keys(store).forEach((k) => delete store[k]); }),
-		});
-
-		vi.stubGlobal("localStorage", createMockStorage(mockStorage));
-		vi.stubGlobal("sessionStorage", createMockStorage(mockStorage2));
-	});
-
-	afterEach(() => { vi.unstubAllGlobals(); });
-
-	test("localStorage operations", () => {
-		updateLocalStorage("foo", { bar: "baz" });
-		expect(localStorage.getItem("foo")).toBe('{"bar":"baz"}');
-		expect(getLocalStorage("foo")).toEqual({ bar: "baz" });
-
-		removeLocalStorage("foo");
-		expect(getLocalStorage("foo")).toBeNull();
-	});
-
-	test("sessionStorage operations", () => {
-		updateSessionStorage("foo", { bar: "baz" });
-		expect(sessionStorage.getItem("foo")).toBe('{"bar":"baz"}');
-		expect(getSessionStorage("foo")).toEqual({ bar: "baz" });
-
-		removeSessionStorage("foo");
-		expect(getSessionStorage("foo")).toBeNull();
-	});
-
-	test("handles invalid json gracefully", () => {
-		localStorage.setItem("invalid", "not-json");
-		expect(getLocalStorage("invalid")).toBeNull();
-	});
-});

package/tests/utils/buildContext.test.tsx

@@ -1,27 +0,0 @@
-import { describe, test, expect } from "vitest";
-import { render, screen } from "@testing-library/react";
-import React from "react";
-import { buildContext } from "@/packages/utils/buildContext";
-
-describe("buildContext", () => {
-	const [Provider, useValue] = buildContext<string>("default");
-
-	function TestComponent() {
-		const val = useValue();
-		return <div data-testid="val">{val}</div>;
-	}
-
-	test("returns default value when not wrapped in provider", () => {
-		render(<TestComponent />);
-		expect(screen.getByTestId("val").textContent).toBe("default");
-	});
-
-	test("returns provided value", () => {
-		render(
-			<Provider value="provided">
-				<TestComponent />
-			</Provider>,
-		);
-		expect(screen.getByTestId("val").textContent).toBe("provided");
-	});
-});

package/tests/utils/checkDevice.test.ts

@@ -1,84 +0,0 @@
-import { describe, test, expect, afterEach } from "vitest";
-import { getDeviceInfo } from "@/packages/utils/checkDevice";
-
-describe("getDeviceInfo", () => {
-	const originalUserAgent = navigator.userAgent;
-
-	afterEach(() => {
-		Object.defineProperty(navigator, "userAgent", {
-			value: originalUserAgent,
-			writable: true,
-			configurable: true,
-		});
-	});
-
-	test("returns default values in SSR (no window)", () => {
-		const win = global.window;
-		(global as any).window = undefined;
-		const info = getDeviceInfo();
-		expect(info.isMobile).toBe(false);
-		expect(info.browser).toBe("unknown");
-		global.window = win;
-	});
-
-	test("detects mobile Chrome", () => {
-		Object.defineProperty(navigator, "userAgent", {
-			value: "Mozilla/5.0 (Linux; Android 13) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Mobile Safari/537.36",
-			writable: true,
-			configurable: true,
-		});
-		const info = getDeviceInfo();
-		expect(info.isMobile).toBe(true);
-		expect(info.isAndroid).toBe(true);
-		expect(info.browser).toBe("chrome");
-	});
-
-	test("detects iOS Safari", () => {
-		Object.defineProperty(navigator, "userAgent", {
-			value: "Mozilla/5.0 (iPhone; CPU iPhone OS 17_0 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/17.0 Mobile/15E148 Safari/604.1",
-			writable: true,
-			configurable: true,
-		});
-		const info = getDeviceInfo();
-		expect(info.isMobile).toBe(true);
-		expect(info.isIOS).toBe(true);
-		expect(info.isSafari).toBe(true);
-		expect(info.isIOSSafari).toBe(true);
-		expect(info.browser).toBe("safari");
-	});
-
-	test("detects desktop Chrome", () => {
-		Object.defineProperty(navigator, "userAgent", {
-			value: "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36",
-			writable: true,
-			configurable: true,
-		});
-		const info = getDeviceInfo();
-		expect(info.isMobile).toBe(false);
-		expect(info.browser).toBe("chrome");
-	});
-
-	test("detects Mac Safari", () => {
-		Object.defineProperty(navigator, "userAgent", {
-			value: "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/17.0 Safari/604.1",
-			writable: true,
-			configurable: true,
-		});
-		const info = getDeviceInfo();
-		expect(info.isMobile).toBe(false);
-		expect(info.isMacSafari).toBe(true);
-		expect(info.isSafari).toBe(true);
-		expect(info.browser).toBe("safari");
-	});
-
-	test("detects Samsung Browser", () => {
-		Object.defineProperty(navigator, "userAgent", {
-			value: "Mozilla/5.0 (Linux; Android 14) AppleWebKit/537.36 (KHTML, like Gecko) SamsungBrowser/24.0 Chrome/120.0.6099.230 Mobile Safari/537.36",
-			writable: true,
-			configurable: true,
-		});
-		const info = getDeviceInfo();
-		expect(info.isSamsungBrowser).toBe(true);
-		expect(info.browser).toBe("samsung");
-	});
-});