d3ro-voice/packages/ui/__tests__/wave-visualizer.test.tsx

256 lines
7.7 KiB
TypeScript

import { afterEach, describe, expect, it, vi } from 'vitest'
const uiHarness = vi.hoisted(() => {
interface RefSlot {
kind: 'ref'
ref: { current: unknown }
}
interface EffectSlot {
kind: 'effect'
deps: readonly unknown[] | undefined
create: () => void | (() => void)
cleanup: (() => void) | undefined
}
type Slot = RefSlot | EffectSlot
const slots: Slot[] = []
const pendingEffects: number[] = []
let cursor = 0
function depsChanged(
prev: readonly unknown[] | undefined,
next: readonly unknown[] | undefined,
): boolean {
if (prev === undefined || next === undefined) return true
if (prev.length !== next.length) return true
for (let i = 0; i < next.length; i += 1) {
if (!Object.is(prev[i], next[i])) return true
}
return false
}
function reset(): void {
for (const slot of slots) {
if (slot.kind === 'effect' && slot.cleanup) {
slot.cleanup()
}
}
slots.length = 0
pendingEffects.length = 0
cursor = 0
}
function renderComponent(fn: () => unknown): void {
cursor = 0
fn()
const indices = pendingEffects.splice(0)
for (const idx of indices) {
const slot = slots[idx]
if (!slot || slot.kind !== 'effect') continue
if (slot.cleanup) {
slot.cleanup()
slot.cleanup = undefined
}
const cleanup = slot.create()
slot.cleanup = typeof cleanup === 'function' ? cleanup : undefined
}
}
function getRef<T>(index = 0): { current: T } {
const slot = slots[index]
if (!slot || slot.kind !== 'ref') {
throw new Error(`Expected ref slot at index ${index}`)
}
return slot.ref as { current: T }
}
let seededCanvas: unknown = null
function setCanvasSeed(canvas: unknown): void {
seededCanvas = canvas
}
const reactMock = {
useRef<T>(initial: T): { current: T } {
const idx = cursor++
const existing = slots[idx]
if (existing && existing.kind === 'ref') {
return existing.ref as { current: T }
}
const value = initial === null && seededCanvas !== null ? (seededCanvas as T) : initial
const slot: RefSlot = { kind: 'ref', ref: { current: value } }
slots[idx] = slot
return slot.ref as { current: T }
},
useEffect(create: () => void | (() => void), deps?: readonly unknown[]): void {
const idx = cursor++
const existing = slots[idx]
if (!existing || existing.kind !== 'effect') {
slots[idx] = { kind: 'effect', deps, create, cleanup: undefined }
pendingEffects.push(idx)
return
}
if (depsChanged(existing.deps, deps)) {
existing.deps = deps
existing.create = create
pendingEffects.push(idx)
}
},
}
return { reset, renderComponent, getRef, setCanvasSeed, reactMock }
})
vi.mock('react', () => ({
...uiHarness.reactMock,
default: uiHarness.reactMock,
}))
vi.mock('react/jsx-runtime', () => ({
Fragment: 'Fragment',
jsx: (type: unknown, props: unknown) => ({ type, props }),
jsxs: (type: unknown, props: unknown) => ({ type, props }),
}))
vi.mock('react/jsx-dev-runtime', () => ({
Fragment: 'Fragment',
jsxDEV: (type: unknown, props: unknown) => ({ type, props }),
}))
import { AudioVisualizerBar } from '../src/components/ds/AudioVisualizerBar'
import { GradientWave } from '../src/components/ds/GradientWave'
import { clampAudioLevel, stepSmoothedAudioLevel } from '../src/components/ds/wave-math'
interface CanvasProbe {
gradientCreates: number
roundRectArgs: number[][]
stepFrames: (count: number) => void
restore: () => void
}
function installCanvasGlobals(width = 240, height = 48): CanvasProbe {
const roundRectArgs: number[][] = []
let gradientCreates = 0
let rafCounter = 0
const rafQueue = new Map<number, FrameRequestCallback>()
const fakeCtx = {
setTransform: vi.fn(),
clearRect: vi.fn(),
beginPath: vi.fn(),
fill: vi.fn(),
roundRect: (...args: number[]) => {
roundRectArgs.push(args)
},
createLinearGradient: () => {
gradientCreates += 1
return { addColorStop: vi.fn() }
},
fillStyle: '',
shadowBlur: 0,
shadowColor: '',
}
const fakeCanvas = {
clientWidth: width,
clientHeight: height,
width: 0,
height: 0,
getContext: () => fakeCtx,
}
class MockResizeObserver {
observe(): void {}
disconnect(): void {}
}
vi.stubGlobal('ResizeObserver', MockResizeObserver)
vi.stubGlobal('window', { devicePixelRatio: 1 })
vi.stubGlobal('requestAnimationFrame', (cb: FrameRequestCallback) => {
rafCounter += 1
rafQueue.set(rafCounter, cb)
return rafCounter
})
vi.stubGlobal('cancelAnimationFrame', (id: number) => {
rafQueue.delete(id)
})
// 최초 렌더 후 canvasRef 에 가짜 캔버스를 주입하기 위해 hook 슬롯에 접근할 수 있도록 헬퍼 반환
;(installCanvasGlobals as { lastCanvas?: unknown }).lastCanvas = fakeCanvas
return {
get gradientCreates() {
return gradientCreates
},
roundRectArgs,
stepFrames(count: number) {
for (let i = 0; i < count; i += 1) {
const next = rafQueue.entries().next()
if (next.done) break
const [id, cb] = next.value
rafQueue.delete(id)
cb(i * 16)
}
},
restore() {
vi.unstubAllGlobals()
},
}
}
describe('AudioVisualizerBar & GradientWave 캔버스 안전성과 성능 계약', () => {
afterEach(() => {
uiHarness.setCanvasSeed(null)
uiHarness.reset()
vi.unstubAllGlobals()
})
it('AudioVisualizerBar_연속프레임렌더시_그라디언트를매프레임재생성하지않고NaN레벨에서도유한한높이를그린다', () => {
const probe = installCanvasGlobals(240, 48)
const fakeCanvas = (installCanvasGlobals as { lastCanvas?: unknown }).lastCanvas
uiHarness.setCanvasSeed(fakeCanvas)
uiHarness.renderComponent(() => AudioVisualizerBar({ audioLevel: Number.NaN, bars: 12 }))
probe.stepFrames(10)
expect(probe.gradientCreates).toBe(1)
expect(probe.roundRectArgs.length).toBe(120)
const hasNonFinite = probe.roundRectArgs.some((args) => args.some((n) => !Number.isFinite(n)))
expect(hasNonFinite).toBe(false)
// NaN 이후 유효 레벨이 들어와도 smoothedRef가 회복되어 정상 동작해야 한다
uiHarness.renderComponent(() => AudioVisualizerBar({ audioLevel: 0.8, bars: 12 }))
probe.roundRectArgs.length = 0
probe.stepFrames(2)
const recoveredHasNaN = probe.roundRectArgs.some((args) => args.some((n) => !Number.isFinite(n)))
expect(recoveredHasNaN).toBe(false)
})
it('GradientWave_NaN및음수오디오레벨에서도_안전하고유한한좌표만그린다', () => {
const probe = installCanvasGlobals(180, 40)
const fakeCanvas = (installCanvasGlobals as { lastCanvas?: unknown }).lastCanvas
uiHarness.setCanvasSeed(fakeCanvas)
uiHarness.renderComponent(() => GradientWave({ audioLevel: Number.NaN }))
probe.stepFrames(5)
const hasNaN = probe.roundRectArgs.some((args) => args.some((n) => !Number.isFinite(n)))
expect(hasNaN).toBe(false)
expect(probe.roundRectArgs.length).toBeGreaterThan(0)
// barWidth + barGap <= 0 이면 무한 루프나 음수 계산 없이 프레임을 건너뛴다
uiHarness.reset()
probe.roundRectArgs.length = 0
uiHarness.setCanvasSeed(fakeCanvas)
uiHarness.renderComponent(() => GradientWave({ audioLevel: 0.5, barWidth: 0, barGap: 0 }))
probe.stepFrames(2)
expect(probe.roundRectArgs).toEqual([])
})
it('waveMath_음수및NaN입력_클램프와스무딩상태회복을보장한다', () => {
expect(clampAudioLevel(-0.5)).toBe(0)
expect(clampAudioLevel(Number.NaN)).toBe(0)
expect(clampAudioLevel(1.8)).toBe(1)
expect(stepSmoothedAudioLevel(Number.NaN, 0.5, 0.5, 0.1)).toBe(0.25)
})
})