@sovereignfs/ui 0.54.0 → 0.89.1

package/src/hooks/__tests__/useDoubleTap.test.tsx

@@ -1,117 +0,0 @@
-// @vitest-environment jsdom
-import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
-import { act, cleanup, fireEvent, render } from '@testing-library/react';
-import { useDoubleTapHandler, useSingleOrDoubleTap } from '../useDoubleTap';
-
-// A minimal harness: the hook returns a handler bound to onClick. Real
-// double-clicks report detail===2; two separate taps report detail===1 each.
-function DoubleTapHarness({ onDouble }: { onDouble: () => void }) {
-  const handle = useDoubleTapHandler<React.MouseEvent>(() => onDouble());
-  return (
-    <button data-testid="btn" onClick={handle}>
-      tap
-    </button>
-  );
-}
-
-function SingleOrDoubleHarness({
-  onSingle,
-  onDouble,
-}: {
-  onSingle: () => void;
-  onDouble: () => void;
-}) {
-  const handle = useSingleOrDoubleTap<React.MouseEvent>(
-    () => onSingle(),
-    () => onDouble(),
-  );
-  return (
-    <button data-testid="btn" onClick={handle}>
-      tap
-    </button>
-  );
-}
-
-describe('useDoubleTapHandler', () => {
-  beforeEach(() => vi.useFakeTimers());
-  afterEach(() => {
-    vi.useRealTimers();
-    cleanup();
-  });
-
-  it('fires immediately on a native double-click (detail === 2)', () => {
-    const onDouble = vi.fn();
-    const { getByTestId } = render(<DoubleTapHarness onDouble={onDouble} />);
-    fireEvent.click(getByTestId('btn'), { detail: 2 });
-    expect(onDouble).toHaveBeenCalledOnce();
-  });
-
-  it('fires on two touch taps within the window', () => {
-    const onDouble = vi.fn();
-    const { getByTestId } = render(<DoubleTapHarness onDouble={onDouble} />);
-    const btn = getByTestId('btn');
-    fireEvent.click(btn, { detail: 1 });
-    act(() => void vi.advanceTimersByTime(100));
-    fireEvent.click(btn, { detail: 1 });
-    expect(onDouble).toHaveBeenCalledOnce();
-  });
-
-  it('does not fire on a single tap', () => {
-    const onDouble = vi.fn();
-    const { getByTestId } = render(<DoubleTapHarness onDouble={onDouble} />);
-    fireEvent.click(getByTestId('btn'), { detail: 1 });
-    act(() => void vi.advanceTimersByTime(1000));
-    expect(onDouble).not.toHaveBeenCalled();
-  });
-});
-
-describe('useSingleOrDoubleTap', () => {
-  beforeEach(() => vi.useFakeTimers());
-  afterEach(() => {
-    vi.useRealTimers();
-    cleanup();
-  });
-
-  it('defers the single action until the double-tap window closes', () => {
-    const onSingle = vi.fn();
-    const onDouble = vi.fn();
-    const { getByTestId } = render(
-      <SingleOrDoubleHarness onSingle={onSingle} onDouble={onDouble} />,
-    );
-    fireEvent.click(getByTestId('btn'), { detail: 1 });
-    // Single must NOT have fired yet — this deferral is the whole point.
-    expect(onSingle).not.toHaveBeenCalled();
-    act(() => void vi.advanceTimersByTime(350));
-    expect(onSingle).toHaveBeenCalledOnce();
-    expect(onDouble).not.toHaveBeenCalled();
-  });
-
-  it('fires double (and never single) when a second tap arrives in time', () => {
-    const onSingle = vi.fn();
-    const onDouble = vi.fn();
-    const { getByTestId } = render(
-      <SingleOrDoubleHarness onSingle={onSingle} onDouble={onDouble} />,
-    );
-    const btn = getByTestId('btn');
-    fireEvent.click(btn, { detail: 1 });
-    act(() => void vi.advanceTimersByTime(100));
-    fireEvent.click(btn, { detail: 1 });
-    act(() => void vi.advanceTimersByTime(500));
-    expect(onDouble).toHaveBeenCalledOnce();
-    expect(onSingle).not.toHaveBeenCalled();
-  });
-
-  it('fires double on a native double-click and cancels the pending single', () => {
-    const onSingle = vi.fn();
-    const onDouble = vi.fn();
-    const { getByTestId } = render(
-      <SingleOrDoubleHarness onSingle={onSingle} onDouble={onDouble} />,
-    );
-    const btn = getByTestId('btn');
-    fireEvent.click(btn, { detail: 1 });
-    fireEvent.click(btn, { detail: 2 });
-    act(() => void vi.advanceTimersByTime(500));
-    expect(onDouble).toHaveBeenCalledOnce();
-    expect(onSingle).not.toHaveBeenCalled();
-  });
-});

package/src/hooks/__tests__/useIsMobile.test.tsx

@@ -1,80 +0,0 @@
-// @vitest-environment jsdom
-import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
-import { act, cleanup, render } from '@testing-library/react';
-import { MOBILE_BREAKPOINT_PX, useIsMobile } from '../useIsMobile';
-
-// Capture the registered change listener so a test can drive a viewport change.
-let changeHandler: ((e: MediaQueryListEvent) => void) | null = null;
-let matches = false;
-let lastQuery = '';
-
-function installMatchMedia() {
-  changeHandler = null;
-  vi.stubGlobal(
-    'matchMedia',
-    vi.fn().mockImplementation((query: string) => {
-      lastQuery = query;
-      return {
-        matches,
-        media: query,
-        addEventListener: (_: string, cb: (e: MediaQueryListEvent) => void) => {
-          changeHandler = cb;
-        },
-        removeEventListener: vi.fn(),
-        addListener: vi.fn(),
-        removeListener: vi.fn(),
-        dispatchEvent: vi.fn(),
-      };
-    }),
-  );
-}
-
-function Harness({ breakpoint }: { breakpoint?: number }) {
-  const isMobile = useIsMobile(breakpoint);
-  return <span data-testid="out">{String(isMobile)}</span>;
-}
-
-describe('useIsMobile', () => {
-  beforeEach(() => {
-    matches = false;
-    installMatchMedia();
-  });
-  afterEach(() => {
-    vi.unstubAllGlobals();
-    cleanup();
-  });
-
-  it('exports the canonical 768px breakpoint', () => {
-    expect(MOBILE_BREAKPOINT_PX).toBe(768);
-  });
-
-  it('defaults to the canonical breakpoint in its query', () => {
-    matches = true;
-    installMatchMedia();
-    render(<Harness />);
-    expect(lastQuery).toBe('(max-width: 768px)');
-  });
-
-  it('reflects the initial matchMedia result after mount', () => {
-    matches = true;
-    installMatchMedia();
-    const { getByTestId } = render(<Harness />);
-    expect(getByTestId('out').textContent).toBe('true');
-  });
-
-  it('updates when the viewport crosses the breakpoint', () => {
-    matches = false;
-    installMatchMedia();
-    const { getByTestId } = render(<Harness />);
-    expect(getByTestId('out').textContent).toBe('false');
-    act(() => changeHandler?.({ matches: true } as MediaQueryListEvent));
-    expect(getByTestId('out').textContent).toBe('true');
-  });
-
-  it('honours a custom breakpoint override', () => {
-    matches = false;
-    installMatchMedia();
-    render(<Harness breakpoint={640} />);
-    expect(lastQuery).toBe('(max-width: 640px)');
-  });
-});

package/src/hooks/__tests__/useIsOffline.test.tsx

@@ -1,53 +0,0 @@
-// @vitest-environment jsdom
-import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
-import { act, cleanup, render } from '@testing-library/react';
-import { useIsOffline } from '../useIsOffline';
-
-function Harness() {
-  const isOffline = useIsOffline();
-  return <span data-testid="out">{String(isOffline)}</span>;
-}
-
-describe('useIsOffline', () => {
-  beforeEach(() => {
-    vi.stubGlobal('navigator', { ...window.navigator, onLine: true });
-  });
-  afterEach(() => {
-    vi.unstubAllGlobals();
-    cleanup();
-  });
-
-  it('reflects navigator.onLine after mount', () => {
-    vi.stubGlobal('navigator', { ...window.navigator, onLine: false });
-    const { getByTestId } = render(<Harness />);
-    expect(getByTestId('out').textContent).toBe('true');
-  });
-
-  it('does not report offline when navigator.onLine is true', () => {
-    const { getByTestId } = render(<Harness />);
-    expect(getByTestId('out').textContent).toBe('false');
-  });
-
-  it('flips on the offline event', () => {
-    const { getByTestId } = render(<Harness />);
-    expect(getByTestId('out').textContent).toBe('false');
-    act(() => window.dispatchEvent(new Event('offline')));
-    expect(getByTestId('out').textContent).toBe('true');
-  });
-
-  it('flips back on the online event', () => {
-    vi.stubGlobal('navigator', { ...window.navigator, onLine: false });
-    const { getByTestId } = render(<Harness />);
-    expect(getByTestId('out').textContent).toBe('true');
-    act(() => window.dispatchEvent(new Event('online')));
-    expect(getByTestId('out').textContent).toBe('false');
-  });
-
-  it('removes its listeners on unmount', () => {
-    const removeSpy = vi.spyOn(window, 'removeEventListener');
-    const { unmount } = render(<Harness />);
-    unmount();
-    expect(removeSpy).toHaveBeenCalledWith('offline', expect.any(Function));
-    expect(removeSpy).toHaveBeenCalledWith('online', expect.any(Function));
-  });
-});

package/src/hooks/__tests__/useLongPress.test.tsx

@@ -1,158 +0,0 @@
-// @vitest-environment jsdom
-import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
-import { act, cleanup, fireEvent, render } from '@testing-library/react';
-import { useLongPress, type UseLongPressOptions } from '../useLongPress';
-
-// Configurable matchMedia mock — usePrefersCoarsePointer reads
-// '(pointer: coarse)', and the SSR-safe hooks read it on mount. Default to a
-// coarse (touch) device so the suppression styles are exercised; individual
-// tests override `coarse` where they assert the desktop path.
-let coarse = true;
-function installMatchMedia() {
-  vi.stubGlobal(
-    'matchMedia',
-    vi.fn().mockImplementation((query: string) => ({
-      matches: query.includes('pointer: coarse') ? coarse : false,
-      media: query,
-      addEventListener: vi.fn(),
-      removeEventListener: vi.fn(),
-      addListener: vi.fn(),
-      removeListener: vi.fn(),
-      dispatchEvent: vi.fn(),
-    })),
-  );
-}
-
-// A tiny harness component: spreads the hook's handlers onto a div so we can
-// fire real pointer events at it via Testing Library.
-function Harness(props: UseLongPressOptions & { testId?: string }) {
-  const { testId = 'target', ...options } = props;
-  const handlers = useLongPress(options);
-  return (
-    <div data-testid={testId} {...handlers}>
-      target
-    </div>
-  );
-}
-
-function pointer(type: 'touch' | 'mouse', x = 0, y = 0) {
-  return { pointerType: type, clientX: x, clientY: y };
-}
-
-describe('useLongPress', () => {
-  beforeEach(() => {
-    coarse = true;
-    installMatchMedia();
-    vi.useFakeTimers();
-  });
-
-  afterEach(() => {
-    vi.runOnlyPendingTimers();
-    vi.useRealTimers();
-    vi.unstubAllGlobals();
-    cleanup();
-  });
-
-  it('fires onLongPress after the delay on a touch press held still', () => {
-    const onLongPress = vi.fn();
-    const { getByTestId } = render(<Harness onLongPress={onLongPress} delay={500} />);
-    fireEvent.pointerDown(getByTestId('target'), pointer('touch'));
-    expect(onLongPress).not.toHaveBeenCalled();
-    act(() => void vi.advanceTimersByTime(500));
-    expect(onLongPress).toHaveBeenCalledOnce();
-  });
-
-  it('does not arm for a mouse pointer (desktop keeps its own affordance)', () => {
-    const onLongPress = vi.fn();
-    const { getByTestId } = render(<Harness onLongPress={onLongPress} delay={500} />);
-    fireEvent.pointerDown(getByTestId('target'), pointer('mouse'));
-    act(() => void vi.advanceTimersByTime(1000));
-    expect(onLongPress).not.toHaveBeenCalled();
-  });
-
-  it('tolerates finger jitter within moveTolerance', () => {
-    const onLongPress = vi.fn();
-    const { getByTestId } = render(
-      <Harness onLongPress={onLongPress} delay={500} moveTolerance={10} />,
-    );
-    const el = getByTestId('target');
-    fireEvent.pointerDown(el, pointer('touch', 0, 0));
-    fireEvent.pointerMove(el, pointer('touch', 4, 4)); // ~5.7px < 10
-    act(() => void vi.advanceTimersByTime(500));
-    expect(onLongPress).toHaveBeenCalledOnce();
-  });
-
-  it('cancels when movement exceeds moveTolerance', () => {
-    const onLongPress = vi.fn();
-    const { getByTestId } = render(
-      <Harness onLongPress={onLongPress} delay={500} moveTolerance={10} />,
-    );
-    const el = getByTestId('target');
-    fireEvent.pointerDown(el, pointer('touch', 0, 0));
-    fireEvent.pointerMove(el, pointer('touch', 20, 0)); // 20px > 10
-    act(() => void vi.advanceTimersByTime(500));
-    expect(onLongPress).not.toHaveBeenCalled();
-  });
-
-  it('cancels on pointercancel (touch converted to scroll)', () => {
-    const onLongPress = vi.fn();
-    const { getByTestId } = render(<Harness onLongPress={onLongPress} delay={500} />);
-    const el = getByTestId('target');
-    fireEvent.pointerDown(el, pointer('touch'));
-    fireEvent.pointerCancel(el, pointer('touch'));
-    act(() => void vi.advanceTimersByTime(500));
-    expect(onLongPress).not.toHaveBeenCalled();
-  });
-
-  it('suppresses the click that may follow, but only for a bounded window', () => {
-    const onLongPress = vi.fn();
-    const { getByTestId } = render(
-      <Harness onLongPress={onLongPress} delay={500} suppressClickMs={700} />,
-    );
-    const el = getByTestId('target');
-    fireEvent.pointerDown(el, pointer('touch'));
-    act(() => void vi.advanceTimersByTime(500));
-    expect(onLongPress).toHaveBeenCalledOnce();
-
-    // A click arriving right after the long-press is swallowed.
-    const suppressed = fireEvent.click(el);
-    expect(suppressed).toBe(false); // preventDefault called → fireEvent returns false
-
-    // After the suppression window, a genuinely unrelated later tap is NOT eaten.
-    act(() => void vi.advanceTimersByTime(800));
-    const allowed = fireEvent.click(el);
-    expect(allowed).toBe(true);
-  });
-
-  it('prevents the OS context menu while a press is pending', () => {
-    const { getByTestId } = render(<Harness onLongPress={vi.fn()} delay={500} />);
-    const el = getByTestId('target');
-    fireEvent.pointerDown(el, pointer('touch'));
-    const prevented = fireEvent.contextMenu(el);
-    expect(prevented).toBe(false); // preventDefault called
-  });
-
-  it('does nothing when disabled', () => {
-    const onLongPress = vi.fn();
-    const { getByTestId } = render(<Harness onLongPress={onLongPress} delay={500} disabled />);
-    fireEvent.pointerDown(getByTestId('target'), pointer('touch'));
-    act(() => void vi.advanceTimersByTime(500));
-    expect(onLongPress).not.toHaveBeenCalled();
-  });
-
-  it('emits suppression styles only on coarse-pointer devices', () => {
-    coarse = true;
-    installMatchMedia();
-    const { getByTestId, rerender } = render(<Harness onLongPress={vi.fn()} testId="coarse" />);
-    // jsdom applies the inline style object; user-select none is the tell.
-    expect(getByTestId('coarse').style.userSelect).toBe('none');
-
-    coarse = false;
-    installMatchMedia();
-    rerender(<Harness onLongPress={vi.fn()} testId="coarse" />);
-    // A remount picks up the new (fine-pointer) matchMedia result.
-    cleanup();
-    const fine = render(<Harness onLongPress={vi.fn()} testId="fine" />);
-    expect(fine.getByTestId('fine').style.userSelect).toBe('');
-  });
-});

package/src/hooks/__tests__/useOfflineTileState.test.tsx

@@ -1,69 +0,0 @@
-// @vitest-environment jsdom
-import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
-import { cleanup, render } from '@testing-library/react';
-import { useOfflineTileState } from '../useOfflineTileState';
-
-function Harness({
-  offline,
-  deviceOnlyAvailable,
-}: {
-  offline: 'offline-first' | 'device-only' | undefined;
-  deviceOnlyAvailable: boolean;
-}) {
-  const state = useOfflineTileState(offline, deviceOnlyAvailable);
-  return <span data-testid="out">{String(state)}</span>;
-}
-
-describe('useOfflineTileState', () => {
-  beforeEach(() => {
-    vi.stubGlobal('navigator', { ...window.navigator, onLine: true });
-  });
-  afterEach(() => {
-    vi.unstubAllGlobals();
-    cleanup();
-  });
-
-  it('is null for a no-tier app while online', () => {
-    const { getByTestId } = render(<Harness offline={undefined} deviceOnlyAvailable={false} />);
-    expect(getByTestId('out').textContent).toBe('null');
-  });
-
-  it('connectivity-dims a no-tier app while offline', () => {
-    vi.stubGlobal('navigator', { ...window.navigator, onLine: false });
-    const { getByTestId } = render(<Harness offline={undefined} deviceOnlyAvailable={false} />);
-    expect(getByTestId('out').textContent).toBe('connectivity-dimmed');
-  });
-
-  it('never dims an offline-first app, online or offline', () => {
-    const online = render(<Harness offline="offline-first" deviceOnlyAvailable={false} />);
-    expect(online.getByTestId('out').textContent).toBe('null');
-    cleanup();
-
-    vi.stubGlobal('navigator', { ...window.navigator, onLine: false });
-    const offline = render(<Harness offline="offline-first" deviceOnlyAvailable={false} />);
-    expect(offline.getByTestId('out').textContent).toBe('null');
-  });
-
-  it('capability-restricts a device-only app when unavailable, regardless of connectivity', () => {
-    const online = render(<Harness offline="device-only" deviceOnlyAvailable={false} />);
-    expect(online.getByTestId('out').textContent).toBe('capability-restricted');
-    cleanup();
-
-    vi.stubGlobal('navigator', { ...window.navigator, onLine: false });
-    const offline = render(<Harness offline="device-only" deviceOnlyAvailable={false} />);
-    expect(offline.getByTestId('out').textContent).toBe('capability-restricted');
-  });
-
-  it('is not restricted for a device-only app when available, and not dimmed offline either', () => {
-    const online = render(<Harness offline="device-only" deviceOnlyAvailable={true} />);
-    expect(online.getByTestId('out').textContent).toBe('null');
-    cleanup();
-
-    // Availability is a capability signal, not a connectivity one — a
-    // device-only app that IS available behaves like offline-first once the
-    // capability question is settled.
-    vi.stubGlobal('navigator', { ...window.navigator, onLine: false });
-    const offline = render(<Harness offline="device-only" deviceOnlyAvailable={true} />);
-    expect(offline.getByTestId('out').textContent).toBe('null');
-  });
-});

package/src/hooks/__tests__/useResponsiveLayout.test.tsx

@@ -1,87 +0,0 @@
-// @vitest-environment jsdom
-import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
-import { act, cleanup, render } from '@testing-library/react';
-import { useResponsiveLayout } from '../useResponsiveLayout';
-
-// Same matchMedia mocking approach as useIsMobile.test.tsx, since this hook
-// is a thin wrapper over it and must not diverge in SSR/breakpoint behavior.
-let changeHandler: ((e: MediaQueryListEvent) => void) | null = null;
-let matches = false;
-let lastQuery = '';
-
-function installMatchMedia() {
-  changeHandler = null;
-  vi.stubGlobal(
-    'matchMedia',
-    vi.fn().mockImplementation((query: string) => {
-      lastQuery = query;
-      return {
-        matches,
-        media: query,
-        addEventListener: (_: string, cb: (e: MediaQueryListEvent) => void) => {
-          changeHandler = cb;
-        },
-        removeEventListener: vi.fn(),
-        addListener: vi.fn(),
-        removeListener: vi.fn(),
-        dispatchEvent: vi.fn(),
-      };
-    }),
-  );
-}
-
-function Harness({ breakpointPx }: { breakpointPx?: number }) {
-  const { isMobile, value } = useResponsiveLayout({
-    web: 'web-tree',
-    mobile: 'mobile-tree',
-    breakpointPx,
-  });
-  return (
-    <span data-testid="out" data-is-mobile={String(isMobile)}>
-      {value}
-    </span>
-  );
-}
-
-describe('useResponsiveLayout', () => {
-  beforeEach(() => {
-    matches = false;
-    installMatchMedia();
-  });
-  afterEach(() => {
-    vi.unstubAllGlobals();
-    cleanup();
-  });
-
-  it('defaults to the web value before/without a mobile match (SSR-safe default)', () => {
-    matches = false;
-    installMatchMedia();
-    const { getByTestId } = render(<Harness />);
-    expect(getByTestId('out').textContent).toBe('web-tree');
-    expect(getByTestId('out').dataset.isMobile).toBe('false');
-  });
-
-  it('picks the mobile value once matchMedia reports a match', () => {
-    matches = true;
-    installMatchMedia();
-    const { getByTestId } = render(<Harness />);
-    expect(getByTestId('out').textContent).toBe('mobile-tree');
-    expect(getByTestId('out').dataset.isMobile).toBe('true');
-  });
-
-  it('swaps live when the viewport crosses the breakpoint', () => {
-    matches = false;
-    installMatchMedia();
-    const { getByTestId } = render(<Harness />);
-    expect(getByTestId('out').textContent).toBe('web-tree');
-    act(() => changeHandler?.({ matches: true } as MediaQueryListEvent));
-    expect(getByTestId('out').textContent).toBe('mobile-tree');
-  });
-
-  it('passes a custom breakpointPx straight through to useIsMobile', () => {
-    matches = false;
-    installMatchMedia();
-    render(<Harness breakpointPx={640} />);
-    expect(lastQuery).toBe('(max-width: 640px)');
-  });
-});

package/src/hooks/__tests__/useSnapCarousel.test.tsx

@@ -1,93 +0,0 @@
-// @vitest-environment jsdom
-import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
-import { act, cleanup, fireEvent, render } from '@testing-library/react';
-import { useSnapCarousel, type UseSnapCarouselOptions } from '../useSnapCarousel';
-
-// jsdom doesn't implement scrollTo on elements.
-beforeEach(() => {
-  vi.useFakeTimers();
-  if (!Element.prototype.scrollTo) {
-    Element.prototype.scrollTo = vi.fn();
-  }
-});
-
-afterEach(() => {
-  vi.runOnlyPendingTimers();
-  vi.useRealTimers();
-  cleanup();
-});
-
-function setLayout(el: HTMLElement, clientWidth: number, scrollLeft: number) {
-  Object.defineProperty(el, 'clientWidth', { value: clientWidth, configurable: true });
-  Object.defineProperty(el, 'scrollLeft', { value: scrollLeft, configurable: true });
-}
-
-function Harness(
-  props: UseSnapCarouselOptions & { onScrollTo?: (fn: (i: number) => void) => void },
-) {
-  const { onScrollTo, ...options } = props;
-  const { scrollRef, scrollToIndex } = useSnapCarousel(options);
-  onScrollTo?.(scrollToIndex);
-  return <div data-testid="scroller" ref={scrollRef} />;
-}
-
-describe('useSnapCarousel', () => {
-  it('calls onSettle with the new index after the debounce window', () => {
-    const onSettle = vi.fn();
-    const { getByTestId } = render(<Harness itemCount={3} onSettle={onSettle} debounceMs={120} />);
-    const el = getByTestId('scroller');
-    setLayout(el, 300, 300); // scrollLeft 300 / width 300 -> index 1
-    fireEvent.scroll(el);
-    expect(onSettle).not.toHaveBeenCalled();
-    act(() => void vi.advanceTimersByTime(120));
-    expect(onSettle).toHaveBeenCalledWith(1);
-  });
-
-  it('debounces repeated scroll events into a single settle call', () => {
-    const onSettle = vi.fn();
-    const { getByTestId } = render(<Harness itemCount={3} onSettle={onSettle} debounceMs={120} />);
-    const el = getByTestId('scroller');
-    setLayout(el, 300, 0);
-    fireEvent.scroll(el);
-    act(() => void vi.advanceTimersByTime(60));
-    setLayout(el, 300, 300);
-    fireEvent.scroll(el);
-    act(() => void vi.advanceTimersByTime(120));
-    expect(onSettle).toHaveBeenCalledOnce();
-    expect(onSettle).toHaveBeenCalledWith(1);
-  });
-
-  it('does not call onSettle again for the same index', () => {
-    const onSettle = vi.fn();
-    const { getByTestId } = render(<Harness itemCount={3} onSettle={onSettle} debounceMs={120} />);
-    const el = getByTestId('scroller');
-    setLayout(el, 300, 300);
-    fireEvent.scroll(el);
-    act(() => void vi.advanceTimersByTime(120));
-    fireEvent.scroll(el);
-    act(() => void vi.advanceTimersByTime(120));
-    expect(onSettle).toHaveBeenCalledOnce();
-  });
-
-  it('clamps the settled index within [0, itemCount - 1]', () => {
-    const onSettle = vi.fn();
-    const { getByTestId } = render(<Harness itemCount={2} onSettle={onSettle} debounceMs={120} />);
-    const el = getByTestId('scroller');
-    setLayout(el, 300, 900); // rounds to index 3, clamps to itemCount - 1 = 1
-    fireEvent.scroll(el);
-    act(() => void vi.advanceTimersByTime(120));
-    expect(onSettle).toHaveBeenCalledWith(1);
-  });
-
-  it('scrollToIndex scrolls the container to the target slide', () => {
-    let scrollToIndex: ((index: number) => void) | undefined;
-    const { getByTestId } = render(
-      <Harness itemCount={3} onScrollTo={(fn) => (scrollToIndex = fn)} />,
-    );
-    const el = getByTestId('scroller');
-    setLayout(el, 400, 0);
-    const spy = vi.spyOn(el, 'scrollTo');
-    scrollToIndex?.(2);
-    expect(spy).toHaveBeenCalledWith({ left: 800, behavior: 'smooth' });
-  });
-});