@astryxdesign/core 0.4.3 → 0.4.4-canary.0f4d45f

package/src/BottomSheet/BottomSheetPanel.test.tsx

@@ -0,0 +1,240 @@
+// Copyright (c) Meta Platforms, Inc. and affiliates.
+
+/**
+ * @file BottomSheetPanel.test.tsx
+ * @input Uses vitest, Testing Library, BottomSheetPanel
+ * @output Tests the shared sheet surface motion contract
+ * @position Internal presentation tests shared by standalone and switcher modes
+ */
+
+import {act, fireEvent, render, screen} from '@testing-library/react';
+import {afterEach, beforeEach, describe, expect, it, vi} from 'vitest';
+import {
+  BottomSheetPanel,
+  type BottomSheetPanelMotion,
+  type BottomSheetPanelState,
+} from './BottomSheetPanel';
+
+const panelTransitionStyle = {
+  transitionProperty: 'transform, opacity',
+  transitionDuration: '410ms',
+  transitionDelay: '0ms',
+};
+
+beforeEach(() => {
+  vi.stubGlobal(
+    'matchMedia',
+    vi.fn().mockReturnValue({
+      matches: false,
+      media: '',
+      onchange: null,
+      addEventListener: vi.fn(),
+      removeEventListener: vi.fn(),
+      addListener: vi.fn(),
+      removeListener: vi.fn(),
+      dispatchEvent: vi.fn(),
+    }),
+  );
+});
+
+afterEach(() => {
+  vi.unstubAllGlobals();
+});
+
+function renderPanel(
+  state: BottomSheetPanelState,
+  callbacks: {
+    onMotionStart?: (motion: BottomSheetPanelMotion) => void;
+    onMotionComplete?: (motion: BottomSheetPanelMotion) => void;
+  } = {},
+) {
+  return render(
+    <BottomSheetPanel
+      state={state}
+      height="hug"
+      style={panelTransitionStyle}
+      onDismiss={() => {}}
+      onScrimOpacity={() => {}}
+      onMotionStart={callbacks.onMotionStart}
+      onMotionComplete={callbacks.onMotionComplete}>
+      Panel content
+    </BottomSheetPanel>,
+  );
+}
+
+function getPanel(): HTMLElement {
+  const panel = screen
+    .getByText('Panel content')
+    .closest<HTMLElement>('.astryx-bottom-sheet');
+  if (panel == null) {
+    throw new Error('BottomSheetPanel surface not found');
+  }
+  return panel;
+}
+
+describe('BottomSheetPanel', () => {
+  it('reports entrance completion only for the surface transform', () => {
+    const onMotionStart = vi.fn();
+    const onMotionComplete = vi.fn();
+    renderPanel(
+      {kind: 'open', entering: true},
+      {onMotionStart, onMotionComplete},
+    );
+
+    expect(onMotionStart).toHaveBeenCalledWith('entering');
+    fireEvent.transitionEnd(getPanel(), {propertyName: 'opacity'});
+    expect(onMotionComplete).not.toHaveBeenCalled();
+    fireEvent.transitionEnd(getPanel(), {propertyName: 'transform'});
+    expect(onMotionComplete).toHaveBeenCalledWith('entering');
+  });
+
+  it('completes a retained-sheet reactivation without waiting for a new entrance', () => {
+    const onMotionComplete = vi.fn();
+    const {rerender} = render(
+      <BottomSheetPanel
+        state={{kind: 'retained', motion: 'covered', alignmentOffset: 0}}
+        height="hug"
+        style={panelTransitionStyle}
+        onDismiss={() => {}}
+        onScrimOpacity={() => {}}
+        onMotionComplete={onMotionComplete}>
+        Panel content
+      </BottomSheetPanel>,
+    );
+
+    rerender(
+      <BottomSheetPanel
+        state={{kind: 'open', entering: true}}
+        height="hug"
+        style={panelTransitionStyle}
+        onDismiss={() => {}}
+        onScrimOpacity={() => {}}
+        onMotionComplete={onMotionComplete}>
+        Panel content
+      </BottomSheetPanel>,
+    );
+
+    expect(onMotionComplete).toHaveBeenCalledWith('entering');
+  });
+
+  it('applies the switcher alignment offset to a retained surface', () => {
+    renderPanel({
+      kind: 'retained',
+      motion: 'aligning',
+      alignmentOffset: 120,
+    });
+
+    expect(getPanel()).toHaveStyle({transform: 'translateY(120px)'});
+  });
+
+  it('maps exit and fade completion to their respective CSS properties', () => {
+    const onMotionComplete = vi.fn();
+    const {rerender} = renderPanel(
+      {kind: 'retained', motion: 'fading', alignmentOffset: 0},
+      {onMotionComplete},
+    );
+
+    fireEvent.transitionEnd(getPanel(), {propertyName: 'opacity'});
+    expect(onMotionComplete).toHaveBeenLastCalledWith('fading');
+
+    rerender(
+      <BottomSheetPanel
+        state={{kind: 'exiting'}}
+        height="hug"
+        style={panelTransitionStyle}
+        onDismiss={() => {}}
+        onScrimOpacity={() => {}}
+        onMotionComplete={onMotionComplete}>
+        Panel content
+      </BottomSheetPanel>,
+    );
+    fireEvent.transitionEnd(getPanel(), {propertyName: 'transform'});
+    expect(onMotionComplete).toHaveBeenLastCalledWith('exiting');
+  });
+
+  it('completes immediately when the rendered transition is disabled', () => {
+    vi.mocked(matchMedia).mockReturnValue({
+      matches: true,
+      media: '(prefers-reduced-motion: reduce)',
+      onchange: null,
+      addEventListener: vi.fn(),
+      removeEventListener: vi.fn(),
+      addListener: vi.fn(),
+      removeListener: vi.fn(),
+      dispatchEvent: vi.fn(),
+    });
+    const onMotionComplete = vi.fn();
+    render(
+      <BottomSheetPanel
+        state={{kind: 'open', entering: true}}
+        height="hug"
+        onDismiss={() => {}}
+        onScrimOpacity={() => {}}
+        onMotionComplete={onMotionComplete}>
+        Panel content
+      </BottomSheetPanel>,
+    );
+
+    expect(onMotionComplete).toHaveBeenCalledWith('entering');
+  });
+
+  it('derives its transition backstop from the rendered timing', () => {
+    vi.useFakeTimers();
+    try {
+      const onMotionComplete = vi.fn();
+      render(
+        <BottomSheetPanel
+          state={{kind: 'open', entering: true}}
+          height="hug"
+          style={{
+            transitionProperty: 'transform, opacity',
+            transitionDuration: '0.5s, 200ms',
+            transitionDelay: '100ms, 0ms',
+          }}
+          onDismiss={() => {}}
+          onScrimOpacity={() => {}}
+          onMotionComplete={onMotionComplete}>
+          Panel content
+        </BottomSheetPanel>,
+      );
+
+      void act(() => vi.advanceTimersByTime(649));
+      expect(onMotionComplete).not.toHaveBeenCalled();
+      void act(() => vi.advanceTimersByTime(1));
+      expect(onMotionComplete).toHaveBeenCalledWith('entering');
+    } finally {
+      vi.useRealTimers();
+    }
+  });
+
+  it('does not detach a stable public ref during an ordinary rerender', () => {
+    const panelRef = vi.fn();
+    const {rerender, unmount} = render(
+      <BottomSheetPanel
+        ref={panelRef}
+        state={{kind: 'open', entering: false}}
+        height="hug"
+        onDismiss={() => {}}
+        onScrimOpacity={() => {}}>
+        First render
+      </BottomSheetPanel>,
+    );
+
+    expect(panelRef).toHaveBeenCalledTimes(1);
+    rerender(
+      <BottomSheetPanel
+        ref={panelRef}
+        state={{kind: 'open', entering: false}}
+        height="hug"
+        onDismiss={() => {}}
+        onScrimOpacity={() => {}}>
+        Second render
+      </BottomSheetPanel>,
+    );
+    expect(panelRef).toHaveBeenCalledTimes(1);
+
+    unmount();
+    expect(panelRef).toHaveBeenLastCalledWith(null);
+    expect(panelRef).toHaveBeenCalledTimes(2);
+  });
+});