@aiquants/virtualscroll 1.20.0 → 1.22.0

package/src/TapScrollCircle.spec.tsx

@@ -1,275 +0,0 @@
-/**
- * Provides regression tests for TapScrollCircle pointer-capture robustness.
- *
- * TapScrollCircle のポインタキャプチャ堅牢化に関する回帰テストを提供。
- */
-import { act, cleanup, fireEvent, render } from "@testing-library/react"
-import { createRef } from "react"
-import { afterEach, beforeAll, describe, expect, it, vi } from "vitest"
-import { TapScrollCircle, type TapScrollCircleDragState, type TapScrollCircleHandle } from "./TapScrollCircle.tsx"
-
-// jsdom は PointerEvent とポインタキャプチャ API を持たないため補完する。
-// jsdom lacks PointerEvent and pointer-capture APIs; polyfill them for these tests.
-beforeAll(() => {
-    if (typeof window.PointerEvent === "undefined") {
-        class PointerEventPolyfill extends MouseEvent {
-            pointerId: number
-            pointerType: string
-            constructor(type: string, params: PointerEventInit = {}) {
-                super(type, params)
-                this.pointerId = params.pointerId ?? 0
-                this.pointerType = params.pointerType ?? "mouse"
-            }
-        }
-        // @ts-expect-error jsdom への PointerEvent 補完
-        window.PointerEvent = PointerEventPolyfill
-    }
-    HTMLElement.prototype.setPointerCapture ??= function setPointerCapture() {}
-    HTMLElement.prototype.releasePointerCapture ??= function releasePointerCapture() {}
-    HTMLElement.prototype.hasPointerCapture ??= function hasPointerCapture() {
-        return false
-    }
-})
-
-afterEach(() => {
-    cleanup()
-})
-
-/**
- * Builds a PointerEvent-like init for jsdom fireEvent.pointer*.
- *
- * jsdom の fireEvent.pointer* 用に PointerEvent 相当の初期化を生成。
- */
-const pointerInit = (pointerId: number, clientX: number, clientY: number) => ({
-    pointerId,
-    clientX,
-    clientY,
-    // jsdom は PointerEvent を持たないため bubbles/pointerType を明示する
-    bubbles: true,
-    pointerType: "touch",
-})
-
-describe("TapScrollCircle pointer capture robustness", () => {
-    it("does not throw when setPointerCapture fails (pointer already inactive)", () => {
-        const onDragChange = vi.fn()
-        const { getByTestId } = render(<TapScrollCircle onDragChange={onDragChange} opacity={1} />)
-        const circle = getByTestId("virtual-scroll-tap-circle") as HTMLDivElement
-
-        // ウインドウ外へ出た直後などをシミュレート: setPointerCapture が NotFoundError を投げる
-        circle.setPointerCapture = () => {
-            throw new DOMException("pointer not found", "NotFoundError")
-        }
-
-        expect(() => {
-            fireEvent.pointerDown(circle, pointerInit(1, 0, 100))
-        }).not.toThrow()
-
-        // キャプチャ失敗後もドラッグ状態は開始している
-        const last = onDragChange.mock.calls.at(-1)?.[0] as TapScrollCircleDragState
-        expect(last.active).toBe(true)
-    })
-
-    it("resets drag state and notifies inactive on lostpointercapture", () => {
-        const onDragChange = vi.fn()
-        const { getByTestId } = render(<TapScrollCircle onDragChange={onDragChange} opacity={1} />)
-        const circle = getByTestId("virtual-scroll-tap-circle") as HTMLDivElement
-        circle.setPointerCapture = vi.fn()
-
-        fireEvent.pointerDown(circle, pointerInit(1, 0, 100))
-        // 下方向へドラッグして direction を確定させる
-        fireEvent.pointerMove(circle, pointerInit(1, 0, 140))
-        const dragging = onDragChange.mock.calls.at(-1)?.[0] as TapScrollCircleDragState
-        expect(dragging.active).toBe(true)
-        expect(dragging.direction).not.toBe(0)
-
-        // 強制的なキャプチャ解放 (pointerup を受け取れないケース)
-        fireEvent.lostPointerCapture(circle, { pointerId: 1, bubbles: true })
-
-        const afterLost = onDragChange.mock.calls.at(-1)?.[0] as TapScrollCircleDragState
-        expect(afterLost.active).toBe(false)
-        expect(afterLost.direction).toBe(0)
-        expect(afterLost.pointerId).toBeNull()
-    })
-
-    it("ignores lostpointercapture for a non-matching pointerId", () => {
-        const onDragChange = vi.fn()
-        const { getByTestId } = render(<TapScrollCircle onDragChange={onDragChange} opacity={1} />)
-        const circle = getByTestId("virtual-scroll-tap-circle") as HTMLDivElement
-        circle.setPointerCapture = vi.fn()
-
-        fireEvent.pointerDown(circle, pointerInit(1, 0, 100))
-        fireEvent.pointerMove(circle, pointerInit(1, 0, 140))
-        const callsBefore = onDragChange.mock.calls.length
-
-        // 別ポインターの lostpointercapture では状態を触らない
-        fireEvent.lostPointerCapture(circle, { pointerId: 99, bubbles: true })
-        expect(onDragChange.mock.calls.length).toBe(callsBefore)
-        const last = onDragChange.mock.calls.at(-1)?.[0] as TapScrollCircleDragState
-        expect(last.active).toBe(true)
-    })
-
-    it("ignores a second pointer while dragging with the first", () => {
-        const onDragChange = vi.fn()
-        const { getByTestId } = render(<TapScrollCircle onDragChange={onDragChange} opacity={1} />)
-        const circle = getByTestId("virtual-scroll-tap-circle") as HTMLDivElement
-        const capture = vi.fn()
-        circle.setPointerCapture = capture
-
-        fireEvent.pointerDown(circle, pointerInit(1, 0, 100))
-        expect(capture).toHaveBeenCalledTimes(1)
-
-        // 2 本目のタッチ (別 pointerId) は無視されるべき
-        fireEvent.pointerDown(circle, pointerInit(2, 0, 100))
-        expect(capture).toHaveBeenCalledTimes(1)
-
-        // ドラッグ中の pointerId は 1 のまま
-        const last = onDragChange.mock.calls.at(-1)?.[0] as TapScrollCircleDragState
-        expect(last.pointerId).toBe(1)
-
-        // 2 本目のポインターの move は無視される
-        const callsBeforeMove = onDragChange.mock.calls.length
-        fireEvent.pointerMove(circle, pointerInit(2, 0, 200))
-        expect(onDragChange.mock.calls.length).toBe(callsBeforeMove)
-    })
-
-    it("hands off control to a waiting second pointer when the primary is released", () => {
-        const onDragChange = vi.fn()
-        const { getByTestId } = render(<TapScrollCircle onDragChange={onDragChange} opacity={1} />)
-        const circle = getByTestId("virtual-scroll-tap-circle") as HTMLDivElement
-        const capture = vi.fn()
-        circle.setPointerCapture = capture
-
-        // finger1 でドラッグ開始
-        fireEvent.pointerDown(circle, pointerInit(1, 0, 100))
-        fireEvent.pointerMove(circle, pointerInit(1, 0, 140))
-        expect((onDragChange.mock.calls.at(-1)?.[0] as TapScrollCircleDragState).active).toBe(true)
-
-        // finger2 をサークルに置く (待機候補として記録される)
-        fireEvent.pointerDown(circle, pointerInit(2, 0, 60))
-
-        // finger1 を離すと finger2 へ制御が移譲される
-        fireEvent.pointerUp(circle, pointerInit(1, 0, 140))
-        const afterHandoff = onDragChange.mock.calls.at(-1)?.[0] as TapScrollCircleDragState
-        expect(afterHandoff.active).toBe(true)
-        expect(afterHandoff.pointerId).toBe(2)
-        expect(capture).toHaveBeenCalledWith(2)
-
-        // 移譲後は finger2 の move でドラッグが継続する
-        fireEvent.pointerMove(circle, pointerInit(2, 0, 200))
-        const moved = onDragChange.mock.calls.at(-1)?.[0] as TapScrollCircleDragState
-        expect(moved.active).toBe(true)
-        expect(moved.pointerId).toBe(2)
-        expect(moved.offsetY).toBe(200)
-
-        // finger2 を離すと通常どおりリセットされる
-        fireEvent.pointerUp(circle, pointerInit(2, 0, 200))
-        const released = onDragChange.mock.calls.at(-1)?.[0] as TapScrollCircleDragState
-        expect(released.active).toBe(false)
-        expect(released.pointerId).toBeNull()
-    })
-
-    it("tracks the waiting pointer position so the handoff starts at its latest location", () => {
-        const onDragChange = vi.fn()
-        const { getByTestId } = render(<TapScrollCircle onDragChange={onDragChange} opacity={1} />)
-        const circle = getByTestId("virtual-scroll-tap-circle") as HTMLDivElement
-        circle.setPointerCapture = vi.fn()
-
-        fireEvent.pointerDown(circle, pointerInit(1, 0, 100))
-        fireEvent.pointerDown(circle, pointerInit(2, 0, 60))
-        // 待機中の finger2 が移動しても座標は追従する (onDragChange は発火しない)
-        const callsBefore = onDragChange.mock.calls.length
-        fireEvent.pointerMove(circle, pointerInit(2, 0, 160))
-        expect(onDragChange.mock.calls.length).toBe(callsBefore)
-
-        fireEvent.pointerUp(circle, pointerInit(1, 0, 100))
-        const afterHandoff = onDragChange.mock.calls.at(-1)?.[0] as TapScrollCircleDragState
-        expect(afterHandoff.active).toBe(true)
-        expect(afterHandoff.pointerId).toBe(2)
-        expect(afterHandoff.offsetY).toBe(160)
-    })
-
-    it("resets normally when the waiting pointer was already released before the primary", () => {
-        const onDragChange = vi.fn()
-        const { getByTestId } = render(<TapScrollCircle onDragChange={onDragChange} opacity={1} />)
-        const circle = getByTestId("virtual-scroll-tap-circle") as HTMLDivElement
-        circle.setPointerCapture = vi.fn()
-
-        fireEvent.pointerDown(circle, pointerInit(1, 0, 100))
-        fireEvent.pointerDown(circle, pointerInit(2, 0, 60))
-        // finger2 が先に離れた場合、候補は破棄され通常のリセットになる
-        fireEvent.pointerUp(circle, pointerInit(2, 0, 60))
-        fireEvent.pointerUp(circle, pointerInit(1, 0, 100))
-        const last = onDragChange.mock.calls.at(-1)?.[0] as TapScrollCircleDragState
-        expect(last.active).toBe(false)
-        expect(last.pointerId).toBeNull()
-    })
-
-    it("treats a cross-realm NotFoundError (name-based) as a dead candidate on handoff", () => {
-        const onDragChange = vi.fn()
-        const { getByTestId } = render(<TapScrollCircle onDragChange={onDragChange} opacity={1} />)
-        const circle = getByTestId("virtual-scroll-tap-circle") as HTMLDivElement
-
-        // クロスレルムの DOMException を模倣: instanceof DOMException は false だが name は NotFoundError
-        class CrossRealmDOMException extends Error {}
-        const crossRealmError = new CrossRealmDOMException("pointer not found")
-        crossRealmError.name = "NotFoundError"
-        expect(crossRealmError instanceof DOMException).toBe(false)
-
-        // 候補ポインタ (2) の生存プローブだけが失敗する
-        circle.setPointerCapture = (pointerId: number) => {
-            if (pointerId === 2) {
-                throw crossRealmError
-            }
-        }
-
-        fireEvent.pointerDown(circle, pointerInit(1, 0, 100))
-        fireEvent.pointerMove(circle, pointerInit(1, 0, 140))
-        // finger2 を待機候補として置くが、既に非アクティブ (プローブが NotFoundError)
-        fireEvent.pointerDown(circle, pointerInit(2, 0, 60))
-        fireEvent.pointerUp(circle, pointerInit(1, 0, 140))
-
-        // 死んだ候補へは移譲されず、状態はリセットされる (active=true 固着の防止)
-        const last = onDragChange.mock.calls.at(-1)?.[0] as TapScrollCircleDragState
-        expect(last.active).toBe(false)
-        expect(last.pointerId).toBeNull()
-    })
-
-    it("continues the handoff when the liveness probe fails with a non-NotFoundError error", () => {
-        const onDragChange = vi.fn()
-        const { getByTestId } = render(<TapScrollCircle onDragChange={onDragChange} opacity={1} />)
-        const circle = getByTestId("virtual-scroll-tap-circle") as HTMLDivElement
-
-        // NotFoundError 以外 (キャプチャ未サポート等) は生死不明のため移譲を継続する
-        circle.setPointerCapture = (pointerId: number) => {
-            if (pointerId === 2) {
-                throw new Error("capture not supported")
-            }
-        }
-
-        fireEvent.pointerDown(circle, pointerInit(1, 0, 100))
-        fireEvent.pointerDown(circle, pointerInit(2, 0, 60))
-        fireEvent.pointerUp(circle, pointerInit(1, 0, 100))
-
-        const last = onDragChange.mock.calls.at(-1)?.[0] as TapScrollCircleDragState
-        expect(last.active).toBe(true)
-        expect(last.pointerId).toBe(2)
-    })
-
-    it("reset() clears state via imperative handle", () => {
-        const onDragChange = vi.fn()
-        const ref = createRef<TapScrollCircleHandle>()
-        const { getByTestId } = render(<TapScrollCircle ref={ref} onDragChange={onDragChange} opacity={1} />)
-        const circle = getByTestId("virtual-scroll-tap-circle") as HTMLDivElement
-        circle.setPointerCapture = vi.fn()
-
-        fireEvent.pointerDown(circle, pointerInit(1, 0, 100))
-        fireEvent.pointerMove(circle, pointerInit(1, 0, 140))
-
-        act(() => {
-            ref.current?.reset()
-        })
-        const last = onDragChange.mock.calls.at(-1)?.[0] as TapScrollCircleDragState
-        expect(last.active).toBe(false)
-        expect(last.pointerId).toBeNull()
-    })
-})