@pyreon/hooks 0.11.4 → 0.11.6

package/src/__tests__/useFocusTrap.test.ts

@@ -1,9 +1,9 @@
-import { afterEach, beforeEach, describe, expect, it, vi } from "vitest"
+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest'
 
 let mountCallbacks: Array<() => void> = []
 let unmountCallbacks: Array<() => void> = []
 
-vi.mock("@pyreon/core", () => ({
+vi.mock('@pyreon/core', () => ({
   onMount: (fn: () => unknown) => {
     mountCallbacks.push(fn as () => void)
   },
@@ -12,9 +12,9 @@ vi.mock("@pyreon/core", () => ({
   },
 }))
 
-import { useFocusTrap } from "../useFocusTrap"
+import { useFocusTrap } from '../useFocusTrap'
 
-describe("useFocusTrap", () => {
+describe('useFocusTrap', () => {
   let container: HTMLDivElement
   let btn1: HTMLButtonElement
   let btn2: HTMLButtonElement
@@ -23,10 +23,10 @@ describe("useFocusTrap", () => {
   beforeEach(() => {
     mountCallbacks = []
     unmountCallbacks = []
-    container = document.createElement("div")
-    btn1 = document.createElement("button")
-    btn2 = document.createElement("button")
-    btn3 = document.createElement("button")
+    container = document.createElement('div')
+    btn1 = document.createElement('button')
+    btn2 = document.createElement('button')
+    btn3 = document.createElement('button')
     container.append(btn1, btn2, btn3)
     document.body.appendChild(container)
   })
@@ -35,84 +35,84 @@ describe("useFocusTrap", () => {
     document.body.removeChild(container)
   })
 
-  it("wraps focus from last to first on Tab", () => {
+  it('wraps focus from last to first on Tab', () => {
     useFocusTrap(() => container)
     mountCallbacks.forEach((cb) => {
       cb()
     })
 
     btn3.focus()
-    const event = new KeyboardEvent("keydown", { key: "Tab", bubbles: true })
-    const prevented = vi.spyOn(event, "preventDefault")
+    const event = new KeyboardEvent('keydown', { key: 'Tab', bubbles: true })
+    const prevented = vi.spyOn(event, 'preventDefault')
     document.dispatchEvent(event)
 
     expect(prevented).toHaveBeenCalled()
     expect(document.activeElement).toBe(btn1)
   })
 
-  it("wraps focus from first to last on Shift+Tab", () => {
+  it('wraps focus from first to last on Shift+Tab', () => {
     useFocusTrap(() => container)
     mountCallbacks.forEach((cb) => {
       cb()
     })
 
     btn1.focus()
-    const event = new KeyboardEvent("keydown", {
-      key: "Tab",
+    const event = new KeyboardEvent('keydown', {
+      key: 'Tab',
       shiftKey: true,
       bubbles: true,
     })
-    const prevented = vi.spyOn(event, "preventDefault")
+    const prevented = vi.spyOn(event, 'preventDefault')
     document.dispatchEvent(event)
 
     expect(prevented).toHaveBeenCalled()
     expect(document.activeElement).toBe(btn3)
   })
 
-  it("does not wrap when Tab on middle element", () => {
+  it('does not wrap when Tab on middle element', () => {
     useFocusTrap(() => container)
     mountCallbacks.forEach((cb) => {
       cb()
     })
 
     btn2.focus()
-    const event = new KeyboardEvent("keydown", { key: "Tab", bubbles: true })
-    const prevented = vi.spyOn(event, "preventDefault")
+    const event = new KeyboardEvent('keydown', { key: 'Tab', bubbles: true })
+    const prevented = vi.spyOn(event, 'preventDefault')
     document.dispatchEvent(event)
 
     expect(prevented).not.toHaveBeenCalled()
   })
 
-  it("ignores non-Tab keys", () => {
+  it('ignores non-Tab keys', () => {
     useFocusTrap(() => container)
     mountCallbacks.forEach((cb) => {
       cb()
     })
 
     btn3.focus()
-    const event = new KeyboardEvent("keydown", { key: "Enter", bubbles: true })
-    const prevented = vi.spyOn(event, "preventDefault")
+    const event = new KeyboardEvent('keydown', { key: 'Enter', bubbles: true })
+    const prevented = vi.spyOn(event, 'preventDefault')
     document.dispatchEvent(event)
 
     expect(prevented).not.toHaveBeenCalled()
   })
 
-  it("does nothing when element is null", () => {
+  it('does nothing when element is null', () => {
     useFocusTrap(() => null)
     mountCallbacks.forEach((cb) => {
       cb()
     })
 
-    const event = new KeyboardEvent("keydown", { key: "Tab", bubbles: true })
-    const prevented = vi.spyOn(event, "preventDefault")
+    const event = new KeyboardEvent('keydown', { key: 'Tab', bubbles: true })
+    const prevented = vi.spyOn(event, 'preventDefault')
     document.dispatchEvent(event)
 
     expect(prevented).not.toHaveBeenCalled()
   })
 
-  it("does nothing when container has no focusable children", () => {
-    const emptyContainer = document.createElement("div")
-    emptyContainer.appendChild(document.createElement("div"))
+  it('does nothing when container has no focusable children', () => {
+    const emptyContainer = document.createElement('div')
+    emptyContainer.appendChild(document.createElement('div'))
     document.body.appendChild(emptyContainer)
 
     useFocusTrap(() => emptyContainer)
@@ -120,16 +120,16 @@ describe("useFocusTrap", () => {
       cb()
     })
 
-    const event = new KeyboardEvent("keydown", { key: "Tab", bubbles: true })
-    const prevented = vi.spyOn(event, "preventDefault")
+    const event = new KeyboardEvent('keydown', { key: 'Tab', bubbles: true })
+    const prevented = vi.spyOn(event, 'preventDefault')
     document.dispatchEvent(event)
 
     expect(prevented).not.toHaveBeenCalled()
     document.body.removeChild(emptyContainer)
   })
 
-  it("cleans up event listener on unmount", () => {
-    const removeSpy = vi.spyOn(document, "removeEventListener")
+  it('cleans up event listener on unmount', () => {
+    const removeSpy = vi.spyOn(document, 'removeEventListener')
     useFocusTrap(() => container)
     mountCallbacks.forEach((cb) => {
       cb()
@@ -138,23 +138,23 @@ describe("useFocusTrap", () => {
       cb()
     })
 
-    expect(removeSpy).toHaveBeenCalledWith("keydown", expect.any(Function))
+    expect(removeSpy).toHaveBeenCalledWith('keydown', expect.any(Function))
     removeSpy.mockRestore()
   })
 
-  it("does not prevent default when Shift+Tab on non-first element", () => {
+  it('does not prevent default when Shift+Tab on non-first element', () => {
     useFocusTrap(() => container)
     mountCallbacks.forEach((cb) => {
       cb()
     })
 
     btn2.focus()
-    const event = new KeyboardEvent("keydown", {
-      key: "Tab",
+    const event = new KeyboardEvent('keydown', {
+      key: 'Tab',
       shiftKey: true,
       bubbles: true,
     })
-    const prevented = vi.spyOn(event, "preventDefault")
+    const prevented = vi.spyOn(event, 'preventDefault')
     document.dispatchEvent(event)
 
     expect(prevented).not.toHaveBeenCalled()

package/src/__tests__/useHover.test.ts

@@ -1,19 +1,19 @@
-import { describe, expect, it } from "vitest"
-import { useHover } from "../useHover"
+import { describe, expect, it } from 'vitest'
+import { useHover } from '../useHover'
 
-describe("useHover", () => {
-  it("initializes with hovered=false", () => {
+describe('useHover', () => {
+  it('initializes with hovered=false', () => {
     const { hovered } = useHover()
     expect(hovered()).toBe(false)
   })
 
-  it("sets hovered to true on mouseEnter", () => {
+  it('sets hovered to true on mouseEnter', () => {
     const { hovered, props } = useHover()
     props.onMouseEnter()
     expect(hovered()).toBe(true)
   })
 
-  it("sets hovered to false on mouseLeave", () => {
+  it('sets hovered to false on mouseLeave', () => {
     const { hovered, props } = useHover()
     props.onMouseEnter()
     expect(hovered()).toBe(true)
@@ -21,7 +21,7 @@ describe("useHover", () => {
     expect(hovered()).toBe(false)
   })
 
-  it("toggles hover state correctly through multiple cycles", () => {
+  it('toggles hover state correctly through multiple cycles', () => {
     const { hovered, props } = useHover()
     props.onMouseEnter()
     expect(hovered()).toBe(true)
@@ -33,26 +33,26 @@ describe("useHover", () => {
     expect(hovered()).toBe(false)
   })
 
-  it("calling mouseLeave when already not hovered is safe", () => {
+  it('calling mouseLeave when already not hovered is safe', () => {
     const { hovered, props } = useHover()
     props.onMouseLeave()
     expect(hovered()).toBe(false)
   })
 
-  it("calling mouseEnter multiple times stays true", () => {
+  it('calling mouseEnter multiple times stays true', () => {
     const { hovered, props } = useHover()
     props.onMouseEnter()
     props.onMouseEnter()
     expect(hovered()).toBe(true)
   })
 
-  it("returns props object with onMouseEnter and onMouseLeave", () => {
+  it('returns props object with onMouseEnter and onMouseLeave', () => {
     const { props } = useHover()
-    expect(typeof props.onMouseEnter).toBe("function")
-    expect(typeof props.onMouseLeave).toBe("function")
+    expect(typeof props.onMouseEnter).toBe('function')
+    expect(typeof props.onMouseLeave).toBe('function')
   })
 
-  it("returns stable handler references", () => {
+  it('returns stable handler references', () => {
     const { props } = useHover()
     const enter = props.onMouseEnter
     const leave = props.onMouseLeave

package/src/__tests__/useIntersection.test.ts

@@ -1,9 +1,9 @@
-import { beforeEach, describe, expect, it, vi } from "vitest"
+import { beforeEach, describe, expect, it, vi } from 'vitest'
 
 let mountCallbacks: Array<() => unknown> = []
 let unmountCallbacks: Array<() => void> = []
 
-vi.mock("@pyreon/core", () => ({
+vi.mock('@pyreon/core', () => ({
   onMount: (fn: () => unknown) => {
     mountCallbacks.push(fn)
   },
@@ -12,9 +12,9 @@ vi.mock("@pyreon/core", () => ({
   },
 }))
 
-import { useIntersection } from "../useIntersection"
+import { useIntersection } from '../useIntersection'
 
-describe("useIntersection", () => {
+describe('useIntersection', () => {
   let intersectionCallback: ((entries: IntersectionObserverEntry[]) => void) | undefined
   let observeSpy: ReturnType<typeof vi.fn>
   let disconnectSpy: ReturnType<typeof vi.fn>
@@ -37,7 +37,7 @@ describe("useIntersection", () => {
         unobserve: vi.fn(),
         disconnect: disconnectSpy,
         root: options?.root ?? null,
-        rootMargin: options?.rootMargin ?? "0px",
+        rootMargin: options?.rootMargin ?? '0px',
         thresholds: Array.isArray(options?.threshold)
           ? options.threshold
           : [options?.threshold ?? 0],
@@ -46,13 +46,13 @@ describe("useIntersection", () => {
     }) as unknown as typeof IntersectionObserver
   })
 
-  it("returns null initially", () => {
+  it('returns null initially', () => {
     const entry = useIntersection(() => null)
     expect(entry()).toBeNull()
   })
 
-  it("observes the element on mount", () => {
-    const el = document.createElement("div")
+  it('observes the element on mount', () => {
+    const el = document.createElement('div')
     useIntersection(() => el)
     mountCallbacks.forEach((cb) => {
       cb()
@@ -61,7 +61,7 @@ describe("useIntersection", () => {
     expect(observeSpy).toHaveBeenCalledWith(el)
   })
 
-  it("does not observe when element is null", () => {
+  it('does not observe when element is null', () => {
     useIntersection(() => null)
     mountCallbacks.forEach((cb) => {
       cb()
@@ -70,8 +70,8 @@ describe("useIntersection", () => {
     expect(observeSpy).not.toHaveBeenCalled()
   })
 
-  it("updates entry when intersection changes", () => {
-    const el = document.createElement("div")
+  it('updates entry when intersection changes', () => {
+    const el = document.createElement('div')
     const entrySignal = useIntersection(() => el)
     mountCallbacks.forEach((cb) => {
       cb()
@@ -92,9 +92,9 @@ describe("useIntersection", () => {
     expect(entrySignal()?.isIntersecting).toBe(true)
   })
 
-  it("passes options to IntersectionObserver", () => {
-    const el = document.createElement("div")
-    const options = { threshold: 0.5, rootMargin: "10px" }
+  it('passes options to IntersectionObserver', () => {
+    const el = document.createElement('div')
+    const options = { threshold: 0.5, rootMargin: '10px' }
     useIntersection(() => el, options)
     mountCallbacks.forEach((cb) => {
       cb()
@@ -103,8 +103,8 @@ describe("useIntersection", () => {
     expect(IntersectionObserver).toHaveBeenCalledWith(expect.any(Function), options)
   })
 
-  it("disconnects observer on unmount", () => {
-    const el = document.createElement("div")
+  it('disconnects observer on unmount', () => {
+    const el = document.createElement('div')
     useIntersection(() => el)
     mountCallbacks.forEach((cb) => {
       cb()
@@ -116,8 +116,8 @@ describe("useIntersection", () => {
     expect(disconnectSpy).toHaveBeenCalled()
   })
 
-  it("does not crash when callback has empty entries", () => {
-    const el = document.createElement("div")
+  it('does not crash when callback has empty entries', () => {
+    const el = document.createElement('div')
     const entrySignal = useIntersection(() => el)
     mountCallbacks.forEach((cb) => {
       cb()
@@ -128,8 +128,8 @@ describe("useIntersection", () => {
     expect(entrySignal()).toBeNull()
   })
 
-  it("updates to latest entry on subsequent intersections", () => {
-    const el = document.createElement("div")
+  it('updates to latest entry on subsequent intersections', () => {
+    const el = document.createElement('div')
     const entrySignal = useIntersection(() => el)
     mountCallbacks.forEach((cb) => {
       cb()

package/src/__tests__/useInterval.test.ts

@@ -1,19 +1,19 @@
-import { afterEach, beforeEach, describe, expect, it, vi } from "vitest"
-import { useInterval } from "../useInterval"
+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest'
+import { useInterval } from '../useInterval'
 
 // Mock onUnmount since it requires component lifecycle context
-vi.mock("@pyreon/core", () => ({
+vi.mock('@pyreon/core', () => ({
   onMount: (fn: () => void) => fn(),
   onUnmount: (_fn: () => void) => {
     /* no-op */
   },
 }))
 
-describe("useInterval", () => {
+describe('useInterval', () => {
   beforeEach(() => vi.useFakeTimers())
   afterEach(() => vi.useRealTimers())
 
-  it("calls callback at the specified interval", () => {
+  it('calls callback at the specified interval', () => {
     const fn = vi.fn()
     useInterval(fn, 100)
 
@@ -24,7 +24,7 @@ describe("useInterval", () => {
     expect(fn).toHaveBeenCalledTimes(2)
   })
 
-  it("does not call callback when delay is null", () => {
+  it('does not call callback when delay is null', () => {
     const fn = vi.fn()
     useInterval(fn, null)
 
@@ -32,7 +32,7 @@ describe("useInterval", () => {
     expect(fn).not.toHaveBeenCalled()
   })
 
-  it("calls the latest callback", () => {
+  it('calls the latest callback', () => {
     let value = 0
     let currentCb = () => {
       value = 1

package/src/__tests__/useIsomorphicLayoutEffect.test.ts

@@ -1,9 +1,9 @@
-import { onMount } from "@pyreon/core"
-import { describe, expect, it } from "vitest"
-import useIsomorphicLayoutEffect from "../useIsomorphicLayoutEffect"
+import { onMount } from '@pyreon/core'
+import { describe, expect, it } from 'vitest'
+import useIsomorphicLayoutEffect from '../useIsomorphicLayoutEffect'
 
-describe("useIsomorphicLayoutEffect", () => {
-  it("is onMount in a browser environment", () => {
+describe('useIsomorphicLayoutEffect', () => {
+  it('is onMount in a browser environment', () => {
     expect(useIsomorphicLayoutEffect).toBe(onMount)
   })
 })

package/src/__tests__/useKeyboard.test.ts

@@ -1,9 +1,9 @@
-import { beforeEach, describe, expect, it, vi } from "vitest"
+import { beforeEach, describe, expect, it, vi } from 'vitest'
 
 let mountCallbacks: Array<() => void> = []
 let unmountCallbacks: Array<() => void> = []
 
-vi.mock("@pyreon/core", () => ({
+vi.mock('@pyreon/core', () => ({
   onMount: (fn: () => unknown) => {
     mountCallbacks.push(fn as () => void)
   },
@@ -12,83 +12,83 @@ vi.mock("@pyreon/core", () => ({
   },
 }))
 
-import { useKeyboard } from "../useKeyboard"
+import { useKeyboard } from '../useKeyboard'
 
-describe("useKeyboard", () => {
+describe('useKeyboard', () => {
   beforeEach(() => {
     mountCallbacks = []
     unmountCallbacks = []
   })
 
-  it("calls handler when the target key is pressed", () => {
+  it('calls handler when the target key is pressed', () => {
     const handler = vi.fn()
-    useKeyboard("Enter", handler)
+    useKeyboard('Enter', handler)
     mountCallbacks.forEach((cb) => {
       cb()
     })
 
-    const event = new KeyboardEvent("keydown", { key: "Enter", bubbles: true })
+    const event = new KeyboardEvent('keydown', { key: 'Enter', bubbles: true })
     document.dispatchEvent(event)
 
     expect(handler).toHaveBeenCalledTimes(1)
     expect(handler).toHaveBeenCalledWith(event)
   })
 
-  it("does not call handler for different keys", () => {
+  it('does not call handler for different keys', () => {
     const handler = vi.fn()
-    useKeyboard("Enter", handler)
+    useKeyboard('Enter', handler)
     mountCallbacks.forEach((cb) => {
       cb()
     })
 
-    const event = new KeyboardEvent("keydown", { key: "Escape", bubbles: true })
+    const event = new KeyboardEvent('keydown', { key: 'Escape', bubbles: true })
     document.dispatchEvent(event)
 
     expect(handler).not.toHaveBeenCalled()
   })
 
-  it("listens for keydown by default", () => {
+  it('listens for keydown by default', () => {
     const handler = vi.fn()
-    const addSpy = vi.spyOn(document, "addEventListener")
-    useKeyboard("Escape", handler)
+    const addSpy = vi.spyOn(document, 'addEventListener')
+    useKeyboard('Escape', handler)
     mountCallbacks.forEach((cb) => {
       cb()
     })
 
-    expect(addSpy).toHaveBeenCalledWith("keydown", expect.any(Function))
+    expect(addSpy).toHaveBeenCalledWith('keydown', expect.any(Function))
     addSpy.mockRestore()
   })
 
-  it("supports keyup event option", () => {
+  it('supports keyup event option', () => {
     const handler = vi.fn()
-    useKeyboard("Space", handler, { event: "keyup" })
+    useKeyboard('Space', handler, { event: 'keyup' })
     mountCallbacks.forEach((cb) => {
       cb()
     })
 
-    const keydownEvent = new KeyboardEvent("keydown", { key: "Space", bubbles: true })
+    const keydownEvent = new KeyboardEvent('keydown', { key: 'Space', bubbles: true })
     document.dispatchEvent(keydownEvent)
     expect(handler).not.toHaveBeenCalled()
 
-    const keyupEvent = new KeyboardEvent("keyup", { key: "Space", bubbles: true })
+    const keyupEvent = new KeyboardEvent('keyup', { key: 'Space', bubbles: true })
     document.dispatchEvent(keyupEvent)
     expect(handler).toHaveBeenCalledTimes(1)
   })
 
-  it("supports custom target", () => {
+  it('supports custom target', () => {
     const handler = vi.fn()
-    const customTarget = document.createElement("div")
+    const customTarget = document.createElement('div')
     document.body.appendChild(customTarget)
-    const addSpy = vi.spyOn(customTarget, "addEventListener")
+    const addSpy = vi.spyOn(customTarget, 'addEventListener')
 
-    useKeyboard("Enter", handler, { target: customTarget })
+    useKeyboard('Enter', handler, { target: customTarget })
     mountCallbacks.forEach((cb) => {
       cb()
     })
 
-    expect(addSpy).toHaveBeenCalledWith("keydown", expect.any(Function))
+    expect(addSpy).toHaveBeenCalledWith('keydown', expect.any(Function))
 
-    const event = new KeyboardEvent("keydown", { key: "Enter", bubbles: true })
+    const event = new KeyboardEvent('keydown', { key: 'Enter', bubbles: true })
     customTarget.dispatchEvent(event)
     expect(handler).toHaveBeenCalledTimes(1)
 
@@ -96,10 +96,10 @@ describe("useKeyboard", () => {
     document.body.removeChild(customTarget)
   })
 
-  it("removes listeners on unmount", () => {
+  it('removes listeners on unmount', () => {
     const handler = vi.fn()
-    const removeSpy = vi.spyOn(document, "removeEventListener")
-    useKeyboard("Enter", handler)
+    const removeSpy = vi.spyOn(document, 'removeEventListener')
+    useKeyboard('Enter', handler)
     mountCallbacks.forEach((cb) => {
       cb()
     })
@@ -107,16 +107,16 @@ describe("useKeyboard", () => {
       cb()
     })
 
-    expect(removeSpy).toHaveBeenCalledWith("keydown", expect.any(Function))
+    expect(removeSpy).toHaveBeenCalledWith('keydown', expect.any(Function))
     removeSpy.mockRestore()
   })
 
-  it("removes listeners from custom target on unmount", () => {
+  it('removes listeners from custom target on unmount', () => {
     const handler = vi.fn()
-    const customTarget = document.createElement("div")
-    const removeSpy = vi.spyOn(customTarget, "removeEventListener")
+    const customTarget = document.createElement('div')
+    const removeSpy = vi.spyOn(customTarget, 'removeEventListener')
 
-    useKeyboard("Enter", handler, { target: customTarget })
+    useKeyboard('Enter', handler, { target: customTarget })
     mountCallbacks.forEach((cb) => {
       cb()
     })
@@ -124,20 +124,20 @@ describe("useKeyboard", () => {
       cb()
     })
 
-    expect(removeSpy).toHaveBeenCalledWith("keydown", expect.any(Function))
+    expect(removeSpy).toHaveBeenCalledWith('keydown', expect.any(Function))
     removeSpy.mockRestore()
   })
 
-  it("calls handler multiple times for repeated key presses", () => {
+  it('calls handler multiple times for repeated key presses', () => {
     const handler = vi.fn()
-    useKeyboard("a", handler)
+    useKeyboard('a', handler)
     mountCallbacks.forEach((cb) => {
       cb()
     })
 
-    document.dispatchEvent(new KeyboardEvent("keydown", { key: "a" }))
-    document.dispatchEvent(new KeyboardEvent("keydown", { key: "a" }))
-    document.dispatchEvent(new KeyboardEvent("keydown", { key: "a" }))
+    document.dispatchEvent(new KeyboardEvent('keydown', { key: 'a' }))
+    document.dispatchEvent(new KeyboardEvent('keydown', { key: 'a' }))
+    document.dispatchEvent(new KeyboardEvent('keydown', { key: 'a' }))
 
     expect(handler).toHaveBeenCalledTimes(3)
   })

package/src/__tests__/useLatest.test.ts

@@ -1,23 +1,23 @@
-import { describe, expect, it } from "vitest"
-import { useLatest } from "../useLatest"
+import { describe, expect, it } from 'vitest'
+import { useLatest } from '../useLatest'
 
-describe("useLatest", () => {
-  it("returns a ref with the current value", () => {
+describe('useLatest', () => {
+  it('returns a ref with the current value', () => {
     const ref = useLatest(42)
     expect(ref.current).toBe(42)
   })
 
-  it("ref object can be manually updated", () => {
-    const ref = useLatest("a")
-    expect(ref.current).toBe("a")
+  it('ref object can be manually updated', () => {
+    const ref = useLatest('a')
+    expect(ref.current).toBe('a')
 
     // In Pyreon, since component runs once, the caller updates .current manually
-    ;(ref as { current: string }).current = "b"
-    expect(ref.current).toBe("b")
+    ;(ref as { current: string }).current = 'b'
+    expect(ref.current).toBe('b')
   })
 
-  it("returns a stable ref identity", () => {
-    const ref = useLatest("hello")
+  it('returns a stable ref identity', () => {
+    const ref = useLatest('hello')
     const same = ref
     expect(same).toBe(ref)
   })