@astryxdesign/core 0.7.5 → 0.7.6-canary.0bd3b37

package/src/BottomSheet/BottomSheetReplace.test.tsx

@@ -1,1638 +0,0 @@
-// Copyright (c) Meta Platforms, Inc. and affiliates.
-
-/**
- * @file BottomSheetReplace.test.tsx
- * @input Uses vitest, @testing-library/react, BottomSheet, BottomSheetSwitcher
- *   and the private bottom-sheet stack registry
- * @output Tests for the replace handoff between standalone sheets: when a
- *   close and an open in one update are a replace and when they are not, the
- *   retained sheet's motion (covered, aligning, fading), one steady scrim,
- *   inertness and dismissal order, focus and the inherited opener, rapid
- *   reversal and dismissal during a handoff, non-modal sheets, and that
- *   switcher flows and lone sheets are untouched
- * @position Core testing; validates the replace path of bottomSheetStack.ts
- *   and BottomSheet.tsx
- *
- * SYNC: When bottomSheetStack.ts or BottomSheet.tsx change the replace
- * handoff, update these tests to match.
- */
-
-import {act, fireEvent, render, screen} from '@testing-library/react';
-import {useEffect, useRef, useState} from 'react';
-import {afterEach, beforeEach, describe, expect, it, vi} from 'vitest';
-import {BottomSheet} from './BottomSheet';
-import {REDUCED_MOTION_COARSE_QUERY} from './BottomSheetPanel';
-import {BottomSheetSwitcher} from './BottomSheetSwitcher';
-import {
-  getBottomSheetStackForTests,
-  resetBottomSheetStackForTests,
-} from './bottomSheetStack';
-import {__resetInteractionModalityForTest} from '../utils/interactionModality';
-
-let nativeLog: {
-  call: 'showModal' | 'show' | 'close' | 'showPopover' | 'hidePopover';
-  dialog: HTMLElement;
-}[] = [];
-
-beforeEach(() => {
-  nativeLog = [];
-  resetBottomSheetStackForTests();
-  __resetInteractionModalityForTest();
-  HTMLDialogElement.prototype.showModal = vi.fn(function (
-    this: HTMLDialogElement,
-  ) {
-    nativeLog.push({call: 'showModal', dialog: this});
-    this.setAttribute('open', '');
-  });
-  HTMLDialogElement.prototype.show = vi.fn(function (this: HTMLDialogElement) {
-    nativeLog.push({call: 'show', dialog: this});
-    this.setAttribute('open', '');
-  });
-  // A non-modal sheet is a manual popover; jsdom's stand-ins keep the same
-  // `open` marker the dialog paths use (the Drawer tests do the same).
-  HTMLElement.prototype.showPopover = vi.fn(function (this: HTMLElement) {
-    nativeLog.push({call: 'showPopover', dialog: this});
-    this.setAttribute('open', '');
-  });
-  HTMLElement.prototype.hidePopover = vi.fn(function (this: HTMLElement) {
-    nativeLog.push({call: 'hidePopover', dialog: this});
-    this.removeAttribute('open');
-  });
-  HTMLDialogElement.prototype.close = vi.fn(function (this: HTMLDialogElement) {
-    nativeLog.push({call: 'close', dialog: this});
-    this.removeAttribute('open');
-  });
-  if (!Element.prototype.setPointerCapture) {
-    Element.prototype.setPointerCapture = vi.fn();
-    Element.prototype.releasePointerCapture = vi.fn();
-  }
-  window.scrollTo = vi.fn();
-  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(),
-    }),
-  );
-  vi.stubGlobal(
-    'requestAnimationFrame',
-    vi.fn((callback: FrameRequestCallback) => {
-      callback(0);
-      return 1;
-    }),
-  );
-  vi.stubGlobal('cancelAnimationFrame', vi.fn());
-});
-
-afterEach(() => {
-  vi.unstubAllGlobals();
-});
-
-// ---------------------------------------------------------------------------
-// Helpers
-// ---------------------------------------------------------------------------
-
-function getDialog(label: string): HTMLDialogElement {
-  const dialog = document.querySelector<HTMLDialogElement>(
-    `dialog[aria-label="${label}"]`,
-  );
-  if (dialog == null) {
-    throw new Error(`dialog "${label}" not found`);
-  }
-  return dialog;
-}
-
-function getPanel(dialog: HTMLElement): HTMLElement {
-  const panel = Array.from(
-    dialog.querySelectorAll<HTMLElement>('.astryx-bottom-sheet'),
-  ).find(candidate => candidate.closest('dialog') === dialog);
-  if (panel == null) {
-    throw new Error('sheet panel not found');
-  }
-  return panel;
-}
-
-function scrim(dialog: HTMLElement): string {
-  return dialog.style.getPropertyValue('--_sheet-scrim-opacity');
-}
-
-function calls(): string[] {
-  return nativeLog.map(
-    entry => `${entry.call}:${entry.dialog.getAttribute('aria-label') ?? '?'}`,
-  );
-}
-
-function openDialogs(): string[] {
-  return Array.from(document.querySelectorAll('dialog[open]')).map(
-    dialog => dialog.getAttribute('aria-label') ?? '?',
-  );
-}
-
-/** `label:state` for every registered sheet, bottom to top. */
-function summary(): string[] {
-  return getBottomSheetStackForTests().map(({element, isOpen, view}) => {
-    const label = element?.getAttribute('aria-label') ?? '?';
-    const state = isOpen
-      ? view.isReplacing
-        ? 'replacing'
-        : view.isTop
-          ? 'top'
-          : 'covered'
-      : view.replacedMotion != null
-        ? `replaced-${view.replacedMotion}`
-        : 'exiting';
-    return `${label}:${state}:${view.depth}`;
-  });
-}
-
-function endMotion(dialog: HTMLElement, propertyName: 'transform' | 'opacity') {
-  fireEvent.transitionEnd(getPanel(dialog), {propertyName});
-}
-
-function pressEscape(): void {
-  document.dispatchEvent(
-    new KeyboardEvent('keydown', {
-      key: 'Escape',
-      bubbles: true,
-      cancelable: true,
-    }),
-  );
-}
-
-/** Give an element a fixed box, the way the browser would lay it out. */
-function layout(element: HTMLElement, top: number, height: number) {
-  element.getBoundingClientRect = () => new DOMRect(0, top, 390, height);
-}
-
-/**
- * Lay out a standalone step as the browser does: its dialog spans the
- * viewport and its panel sits directly in it, `top` from the viewport top.
- * Nothing between them marks where the panel rests.
- */
-function layoutSheet(dialog: HTMLElement, top: number, height: number) {
-  layout(dialog, 0, 844);
-  layout(getPanel(dialog), top, height);
-}
-
-/**
- * Give a panel the computed transform a browser reports while it travels
- * `offset` px below where it rests (an entrance in flight), with the matrix
- * type the browser has and jsdom lacks. Returns the undo.
- */
-function travel(panel: HTMLElement, offset: number): () => void {
-  const view = panel.ownerDocument.defaultView as Window & {
-    DOMMatrixReadOnly?: unknown;
-  };
-  class Matrix {
-    m42: number;
-    constructor(transform: string) {
-      const values = /^matrix\((.*)\)$/.exec(transform)?.[1].split(',') ?? [];
-      this.m42 = Number(values[5] ?? 0);
-    }
-  }
-  const hadMatrix = 'DOMMatrixReadOnly' in view;
-  const previousMatrix = view.DOMMatrixReadOnly;
-  view.DOMMatrixReadOnly = Matrix;
-  const getComputedStyle = view.getComputedStyle.bind(view);
-  const spy = vi
-    .spyOn(view, 'getComputedStyle')
-    .mockImplementation((element, pseudo) => {
-      const style = getComputedStyle(element, pseudo);
-      if (element === panel) {
-        // Each call returns a fresh declaration; shadow its `transform`.
-        Object.defineProperty(style, 'transform', {
-          value: `matrix(1, 0, 0, 1, 0, ${offset})`,
-        });
-      }
-      return style;
-    });
-  return () => {
-    spy.mockRestore();
-    if (hadMatrix) {
-      view.DOMMatrixReadOnly = previousMatrix;
-    } else {
-      delete view.DOMMatrixReadOnly;
-    }
-  };
-}
-
-type Step = 'one' | 'two' | 'three' | null;
-
-/**
- * A three-step flow of standalone sheets: one state value names the open
- * step, so moving on closes one sheet and opens the next in one update.
- */
-function Flow({
-  hasScrim = true,
-  initialStep = null,
-  withBystander = false,
-  reversed = false,
-  twoHasAutofocusField = false,
-}: {
-  hasScrim?: boolean;
-  initialStep?: Step;
-  withBystander?: boolean;
-  /** Write the steps in reverse order in the tree (three, two, one). */
-  reversed?: boolean;
-  /** Step two carries a `data-autofocus` field. */
-  twoHasAutofocusField?: boolean;
-}) {
-  const [step, setStep] = useState<Step>(initialStep);
-  const [isBystanderOpen, setIsBystanderOpen] = useState(false);
-  const stepProps = (own: Step) => ({
-    isOpen: step === own,
-    onOpenChange: (isOpen: boolean) => {
-      if (!isOpen) {
-        setStep(current => (current === own ? null : current));
-      }
-    },
-    hasScrim,
-  });
-  const steps = [
-    <BottomSheet key="one" {...stepProps('one')} label="One">
-      <button type="button" onClick={() => setStep('two')}>
-        Continue to two
-      </button>
-      <button type="button" onClick={() => setIsBystanderOpen(true)}>
-        Open bystander
-      </button>
-    </BottomSheet>,
-    <BottomSheet key="two" {...stepProps('two')} label="Two">
-      {twoHasAutofocusField ? <input aria-label="Name" data-autofocus /> : null}
-      <button type="button" onClick={() => setStep('one')}>
-        Back to one
-      </button>
-      <button type="button" onClick={() => setStep('three')}>
-        Continue to three
-      </button>
-      <button type="button" onClick={() => setStep(null)}>
-        Finish
-      </button>
-    </BottomSheet>,
-    <BottomSheet key="three" {...stepProps('three')} label="Three">
-      <button type="button" onClick={() => setStep('two')}>
-        Back to two
-      </button>
-    </BottomSheet>,
-  ];
-  return (
-    <>
-      <button type="button" onClick={() => setStep('one')}>
-        Open flow
-      </button>
-      {withBystander ? (
-        <BottomSheet
-          isOpen={isBystanderOpen}
-          onOpenChange={setIsBystanderOpen}
-          label="Bystander">
-          bystander
-        </BottomSheet>
-      ) : null}
-      {reversed ? [...steps].reverse() : steps}
-    </>
-  );
-}
-
-/**
- * A real tap: the press that a browser delivers before the click, and that
- * the registry reads to know where the person acted from. A non-modal sheet
- * never takes focus, so `activeElement` says nothing there; the press does.
- */
-function tap(element: HTMLElement) {
-  fireEvent.pointerDown(element, {pointerId: 1, button: 0, isPrimary: true});
-  fireEvent.click(element);
-}
-
-function openFlow() {
-  const opener = screen.getByRole('button', {name: 'Open flow'});
-  opener.focus();
-  fireEvent.click(opener);
-  return opener;
-}
-
-// ---------------------------------------------------------------------------
-// R1: what is, and is not, a replace
-// ---------------------------------------------------------------------------
-
-describe('BottomSheet replace: recognising a replace', () => {
-  it('a top sheet closing while another opens in the same update is replaced', () => {
-    render(<Flow />);
-    openFlow();
-    expect(summary()).toEqual(['One:top:0']);
-    fireEvent.click(screen.getByRole('button', {name: 'Continue to two'}));
-    expect(summary()).toEqual(['One:replaced-covered:0', 'Two:replacing:0']);
-    expect(openDialogs()).toEqual(['One', 'Two']);
-    expect(getDialog('One')).toHaveAttribute('data-sheet-stack', 'replaced');
-    expect(getDialog('Two')).toHaveAttribute('data-sheet-stack', 'top');
-    expect(calls()).toEqual(['showModal:One', 'showModal:Two']);
-  });
-
-  it('a sheet opening over an open sheet is a push, not a replace', () => {
-    render(<Flow withBystander />);
-    openFlow();
-    fireEvent.click(screen.getByRole('button', {name: 'Open bystander'}));
-    expect(summary()).toEqual(['One:covered:1', 'Bystander:top:0']);
-    expect(getDialog('One')).toHaveAttribute('data-sheet-stack', 'covered');
-  });
-
-  it('a sheet closing on its own is a pop, not a replace', () => {
-    render(<Flow initialStep="two" />);
-    fireEvent.click(screen.getByRole('button', {name: 'Finish'}));
-    expect(summary()).toEqual(['Two:exiting:0']);
-    expect(getDialog('Two')).not.toHaveAttribute('data-sheet-stack');
-  });
-
-  it('a close and an open in different updates are a pop and a push', () => {
-    render(<Flow initialStep="two" />);
-    fireEvent.click(screen.getByRole('button', {name: 'Finish'}));
-    fireEvent.click(screen.getByRole('button', {name: 'Open flow'}));
-    expect(summary()).toEqual(['Two:exiting:1', 'One:top:0']);
-  });
-
-  it('a covered sheet closing while a sheet opens is not a replace', () => {
-    // Bystander is open over step one; one update closes the covered step
-    // one (not the top) and opens step two: two pushes over the bystander
-    // and one slides out beneath it.
-    function Harness() {
-      const [isOneOpen, setIsOneOpen] = useState(true);
-      const [isBystanderOpen, setIsBystanderOpen] = useState(false);
-      const [isTwoOpen, setIsTwoOpen] = useState(false);
-      return (
-        <>
-          <button
-            type="button"
-            onClick={() => {
-              setIsOneOpen(false);
-              setIsTwoOpen(true);
-            }}>
-            Swap beneath
-          </button>
-          <BottomSheet
-            isOpen={isOneOpen}
-            onOpenChange={setIsOneOpen}
-            label="One">
-            <button type="button" onClick={() => setIsBystanderOpen(true)}>
-              Open bystander
-            </button>
-          </BottomSheet>
-          <BottomSheet
-            isOpen={isBystanderOpen}
-            onOpenChange={setIsBystanderOpen}
-            label="Bystander">
-            x
-          </BottomSheet>
-          <BottomSheet
-            isOpen={isTwoOpen}
-            onOpenChange={setIsTwoOpen}
-            label="Two">
-            x
-          </BottomSheet>
-        </>
-      );
-    }
-    render(<Harness />);
-    fireEvent.click(screen.getByRole('button', {name: 'Open bystander'}));
-    expect(summary()).toEqual(['One:covered:1', 'Bystander:top:0']);
-    fireEvent.click(screen.getByRole('button', {name: 'Swap beneath'}));
-    expect(summary()).toEqual([
-      'One:exiting:2',
-      'Bystander:covered:1',
-      'Two:top:0',
-    ]);
-  });
-
-  it('a switcher flow closing while a standalone sheet opens is never paired', () => {
-    function Harness() {
-      const [active, setActive] = useState<string | null>('step');
-      const [isSheetOpen, setIsSheetOpen] = useState(false);
-      return (
-        <>
-          <button
-            type="button"
-            onClick={() => {
-              setActive(null);
-              setIsSheetOpen(true);
-            }}>
-            Leave flow for sheet
-          </button>
-          <BottomSheetSwitcher
-            activeSheet={active}
-            onActiveSheetChange={setActive}
-            aria-label="Flow">
-            <BottomSheet sheetId="step" label="Step">
-              x
-            </BottomSheet>
-          </BottomSheetSwitcher>
-          <BottomSheet
-            isOpen={isSheetOpen}
-            onOpenChange={setIsSheetOpen}
-            label="Sheet">
-            x
-          </BottomSheet>
-        </>
-      );
-    }
-    render(<Harness />);
-    fireEvent.click(screen.getByRole('button', {name: 'Leave flow for sheet'}));
-    expect(summary()).toEqual(['Flow:exiting:1', 'Sheet:top:0']);
-  });
-
-  it('a sheet on its own carries no replace state', () => {
-    render(<Flow />);
-    openFlow();
-    const [one] = getBottomSheetStackForTests();
-    expect(one.view).toMatchObject({
-      replacedMotion: null,
-      alignmentOffset: 0,
-      isReplacing: false,
-      isStacked: false,
-    });
-    expect(getDialog('One')).not.toHaveAttribute('data-sheet-stack');
-    expect(calls()).toEqual(['showModal:One']);
-  });
-});
-
-// ---------------------------------------------------------------------------
-// R2: the handoff
-// ---------------------------------------------------------------------------
-
-describe('BottomSheet replace: the handoff', () => {
-  it('keeps the replaced sheet in place, inert and hidden, while the new sheet enters', () => {
-    render(<Flow />);
-    openFlow();
-    fireEvent.click(screen.getByRole('button', {name: 'Continue to two'}));
-    const one = getDialog('One');
-    const two = getDialog('Two');
-    expect(one.open).toBe(true);
-    expect(one).toHaveAttribute('inert');
-    expect(one).toHaveAttribute('aria-hidden', 'true');
-    expect(one).not.toHaveAttribute('aria-modal');
-    expect(two).toHaveAttribute('aria-modal', 'true');
-    expect(two).not.toHaveAttribute('inert');
-    // Not receded: a replaced sheet is at the new sheet's level, not under it.
-    expect(one).not.toHaveAttribute('data-sheet-stack-depth');
-    // The retained panel stays put (no exit transform) and takes no pointer.
-    expect(getPanel(one).style.transform).toBe('');
-    expect(getComputedStyle(getPanel(one)).pointerEvents).toBe('none');
-  });
-
-  it('fades the replaced sheet only after the entering motion completes, then closes its dialog', () => {
-    render(<Flow />);
-    openFlow();
-    fireEvent.click(screen.getByRole('button', {name: 'Continue to two'}));
-    const one = getDialog('One');
-    const two = getDialog('Two');
-    expect(summary()).toEqual(['One:replaced-covered:0', 'Two:replacing:0']);
-    endMotion(two, 'transform');
-    expect(summary()).toEqual(['One:replaced-fading:0', 'Two:replacing:0']);
-    expect(one.open).toBe(true);
-    endMotion(one, 'opacity');
-    expect(summary()).toEqual(['Two:top:0']);
-    expect(openDialogs()).toEqual(['Two']);
-    expect(calls()).toEqual(['showModal:One', 'showModal:Two', 'close:One']);
-    expect(two).not.toHaveAttribute('data-sheet-stack');
-  });
-
-  it('moves a taller replaced sheet down to the entering sheet, concurrently, and fades after both finish', () => {
-    render(<Flow />);
-    openFlow();
-    const one = getDialog('One');
-    const two = getDialog('Two');
-    // Step one is 400px tall; step two will rest 160px lower. The panels are
-    // mounted already, so lay them out before the switch: the alignment is
-    // measured when the entering motion starts.
-    layoutSheet(one, 444, 400);
-    layoutSheet(two, 604, 240);
-    fireEvent.click(screen.getByRole('button', {name: 'Continue to two'}));
-    expect(summary()).toEqual(['One:replaced-aligning:0', 'Two:replacing:0']);
-    expect(getPanel(one).style.transform).toBe('translateY(160px)');
-    // Entering finished first: wait for the alignment.
-    endMotion(two, 'transform');
-    expect(summary()).toEqual(['One:replaced-aligning:0', 'Two:replacing:0']);
-    endMotion(one, 'transform');
-    expect(summary()).toEqual(['One:replaced-fading:0', 'Two:replacing:0']);
-    endMotion(one, 'opacity');
-    expect(summary()).toEqual(['Two:top:0']);
-  });
-
-  it('waits for the entering motion when the alignment finishes first', () => {
-    render(<Flow />);
-    openFlow();
-    const one = getDialog('One');
-    const two = getDialog('Two');
-    layoutSheet(one, 444, 400);
-    layoutSheet(two, 604, 240);
-    fireEvent.click(screen.getByRole('button', {name: 'Continue to two'}));
-    endMotion(one, 'transform');
-    expect(summary()).toEqual(['One:replaced-aligning:0', 'Two:replacing:0']);
-    endMotion(two, 'transform');
-    expect(summary()).toEqual(['One:replaced-fading:0', 'Two:replacing:0']);
-  });
-
-  it('leaves a shorter replaced sheet where it is', () => {
-    render(<Flow />);
-    openFlow();
-    const one = getDialog('One');
-    const two = getDialog('Two');
-    layoutSheet(one, 604, 240);
-    layoutSheet(two, 444, 400);
-    fireEvent.click(screen.getByRole('button', {name: 'Continue to two'}));
-    expect(summary()).toEqual(['One:replaced-covered:0', 'Two:replacing:0']);
-    expect(getPanel(one).style.transform).toBe('');
-  });
-
-  it('aligns to where the entering sheet comes to rest, not where its entrance has it', () => {
-    render(<Flow />);
-    openFlow();
-    const one = getDialog('One');
-    const two = getDialog('Two');
-    layoutSheet(one, 444, 400);
-    // Two rests at 604 but is still 240px below that, rising.
-    layoutSheet(two, 844, 240);
-    const restore = travel(getPanel(two), 240);
-    try {
-      fireEvent.click(screen.getByRole('button', {name: 'Continue to two'}));
-    } finally {
-      restore();
-    }
-    expect(summary()).toEqual(['One:replaced-aligning:0', 'Two:replacing:0']);
-    expect(getPanel(one).style.transform).toBe('translateY(160px)');
-  });
-
-  it('moves the taller sheet back down when the person goes back to a shorter step', () => {
-    render(<Flow />);
-    openFlow();
-    fireEvent.click(screen.getByRole('button', {name: 'Continue to two'}));
-    endMotion(getDialog('Two'), 'transform');
-    endMotion(getDialog('One'), 'opacity');
-    fireEvent.click(screen.getByRole('button', {name: 'Continue to three'}));
-    endMotion(getDialog('Three'), 'transform');
-    endMotion(getDialog('Two'), 'opacity');
-    expect(summary()).toEqual(['Three:top:0']);
-    const two = getDialog('Two');
-    const three = getDialog('Three');
-    layoutSheet(three, 388, 456);
-    layoutSheet(two, 444, 400);
-    fireEvent.click(screen.getByRole('button', {name: 'Back to two'}));
-    expect(summary()).toEqual(['Three:replaced-aligning:0', 'Two:replacing:0']);
-    expect(getPanel(three).style.transform).toBe('translateY(56px)');
-    endMotion(two, 'transform');
-    endMotion(three, 'transform');
-    expect(summary()).toEqual(['Three:replaced-fading:0', 'Two:replacing:0']);
-    endMotion(three, 'opacity');
-    expect(summary()).toEqual(['Two:top:0']);
-  });
-
-  it('keeps the scrim on the replaced sheet and hands it to the new sheet with no fade', () => {
-    render(<Flow />);
-    openFlow();
-    fireEvent.click(screen.getByRole('button', {name: 'Continue to two'}));
-    const one = getDialog('One');
-    const two = getDialog('Two');
-    expect(scrim(one)).toBe('1');
-    expect(scrim(two)).toBe('0');
-    // The flip to 1 lands with the transition pinned to 0s (rAF is
-    // synchronous here, so the pin is lifted again by the time we look).
-    const pins: string[] = [];
-    const setProperty = CSSStyleDeclaration.prototype.setProperty;
-    CSSStyleDeclaration.prototype.setProperty = function (name, value) {
-      if (
-        this === two.style &&
-        name === '--_sheet-scrim-opacity' &&
-        value === '1'
-      ) {
-        pins.push(this.getPropertyValue('--_sheet-scrim-duration'));
-      }
-      return setProperty.call(this, name, value);
-    };
-    endMotion(two, 'transform');
-    endMotion(one, 'opacity');
-    CSSStyleDeclaration.prototype.setProperty = setProperty;
-    expect(scrim(two)).toBe('1');
-    expect(pins[0]).toBe('0s');
-    expect(two.style.getPropertyValue('--_sheet-scrim-duration')).toBe('');
-    expect(one.open).toBe(false);
-  });
-
-  it('runs the replace one level up a stack and leaves the sheet beneath covered', () => {
-    function Harness() {
-      const [isBaseOpen, setIsBaseOpen] = useState(true);
-      const [step, setStep] = useState<'a' | 'b' | null>('a');
-      return (
-        <>
-          <BottomSheet
-            isOpen={isBaseOpen}
-            onOpenChange={setIsBaseOpen}
-            label="Base">
-            x
-          </BottomSheet>
-          <BottomSheet
-            isOpen={step === 'a'}
-            onOpenChange={o => !o && setStep(null)}
-            label="A">
-            <button type="button" onClick={() => setStep('b')}>
-              Next
-            </button>
-          </BottomSheet>
-          <BottomSheet
-            isOpen={step === 'b'}
-            onOpenChange={o => !o && setStep(null)}
-            label="B">
-            x
-          </BottomSheet>
-        </>
-      );
-    }
-    render(<Harness />);
-    expect(summary()).toEqual(['Base:covered:1', 'A:top:0']);
-    fireEvent.click(screen.getByRole('button', {name: 'Next'}));
-    expect(summary()).toEqual([
-      'Base:covered:1',
-      'A:replaced-covered:0',
-      'B:replacing:0',
-    ]);
-    expect(scrim(getDialog('Base'))).toBe('1');
-    expect(scrim(getDialog('A'))).toBe('0');
-    expect(scrim(getDialog('B'))).toBe('0');
-    endMotion(getDialog('B'), 'transform');
-    endMotion(getDialog('A'), 'opacity');
-    expect(summary()).toEqual(['Base:covered:1', 'B:top:0']);
-    expect(scrim(getDialog('Base'))).toBe('1');
-    expect(scrim(getDialog('B'))).toBe('0');
-  });
-});
-
-// ---------------------------------------------------------------------------
-// R3: focus, dismissal, and interruptions
-// ---------------------------------------------------------------------------
-
-describe('BottomSheet replace: focus and dismissal', () => {
-  it('moves focus into the entering sheet and keeps it there when the replaced dialog closes', () => {
-    render(<Flow />);
-    openFlow();
-    const one = getDialog('One');
-    const two = getDialog('Two');
-    const next = screen.getByRole('button', {name: 'Continue to two'});
-    next.focus();
-    fireEvent.click(next);
-    expect(document.activeElement).toBe(getPanel(two));
-    endMotion(two, 'transform');
-    endMotion(one, 'opacity');
-    expect(document.activeElement).toBe(getPanel(two));
-  });
-
-  it.each([
-    ['modal', true],
-    ['non-modal', false],
-  ] as const)(
-    'a %s step entering by a replace focuses its data-autofocus field, even though the native focusing steps already put focus on its panel',
-    (_name, hasScrim) => {
-      // What a browser does: showModal() (or the panel focus of a non-modal
-      // host) moves focus to the entering panel before the registry places
-      // it. The stubs here reproduce that instead of leaving focus on the
-      // pressed button, so the placement has to run after the native steps
-      // and must not stop at "focus is already inside".
-      const focusPanelOnShow = function (this: HTMLElement) {
-        this.setAttribute('open', '');
-        this.querySelector<HTMLElement>('.astryx-bottom-sheet')?.focus();
-      };
-      HTMLDialogElement.prototype.showModal = vi.fn(focusPanelOnShow);
-      HTMLElement.prototype.showPopover = vi.fn(focusPanelOnShow);
-      render(<Flow hasScrim={hasScrim} twoHasAutofocusField />);
-      openFlow();
-      const two = getDialog('Two');
-      const next = screen.getByRole('button', {name: 'Continue to two'});
-      next.focus();
-      fireEvent.click(next);
-      const field = screen.getByRole('textbox', {name: 'Name'});
-      expect(two.contains(field)).toBe(true);
-      expect(document.activeElement).toBe(field);
-      endMotion(two, 'transform');
-      endMotion(getDialog('One'), 'opacity');
-      expect(document.activeElement).toBe(field);
-    },
-  );
-
-  it('a step entering by a replace without a data-autofocus field keeps the focus the native steps put on its panel', () => {
-    HTMLDialogElement.prototype.showModal = vi.fn(function (this: HTMLElement) {
-      this.setAttribute('open', '');
-      this.querySelector<HTMLElement>('.astryx-bottom-sheet')?.focus();
-    });
-    render(<Flow />);
-    openFlow();
-    const two = getDialog('Two');
-    const next = screen.getByRole('button', {name: 'Continue to two'});
-    next.focus();
-    fireEvent.click(next);
-    expect(document.activeElement).toBe(getPanel(two));
-  });
-
-  it('returns focus to the element that opened the flow when the replacing sheet closes it', () => {
-    render(<Flow />);
-    const opener = openFlow();
-    const next = screen.getByRole('button', {name: 'Continue to two'});
-    next.focus();
-    fireEvent.click(next);
-    const one = getDialog('One');
-    const two = getDialog('Two');
-    endMotion(two, 'transform');
-    endMotion(one, 'opacity');
-    fireEvent.click(screen.getByRole('button', {name: 'Finish'}));
-    endMotion(two, 'transform');
-    expect(openDialogs()).toEqual([]);
-    expect(document.activeElement).toBe(opener);
-  });
-
-  it('routes Escape to the replacing sheet, not the replaced one, during the handoff', () => {
-    render(<Flow />);
-    openFlow();
-    fireEvent.click(screen.getByRole('button', {name: 'Continue to two'}));
-    act(() => {
-      pressEscape();
-    });
-    // Two closed the flow; one was dropped at once; both leave.
-    expect(summary()).toEqual(['Two:exiting:0']);
-    expect(getDialog('One').open).toBe(false);
-    expect(getDialog('Two').open).toBe(true);
-  });
-
-  it('routes Escape to the sheet that came back, during a reversal', () => {
-    render(<Flow initialStep="two" />);
-    fireEvent.click(screen.getByRole('button', {name: 'Back to one'}));
-    expect(summary()).toEqual(['Two:replaced-covered:0', 'One:replacing:0']);
-    act(() => {
-      pressEscape();
-    });
-    expect(summary()).toEqual(['One:exiting:0']);
-  });
-
-  it('drops the replaced sheet at once when the replacing sheet is dismissed mid-handoff', () => {
-    render(<Flow />);
-    openFlow();
-    fireEvent.click(screen.getByRole('button', {name: 'Continue to two'}));
-    const one = getDialog('One');
-    const two = getDialog('Two');
-    fireEvent.click(screen.getByRole('button', {name: 'Finish'}));
-    expect(one.open).toBe(false);
-    expect(two.open).toBe(true);
-    expect(scrim(two)).toBe('0');
-    endMotion(two, 'transform');
-    expect(openDialogs()).toEqual([]);
-  });
-
-  it('a reversal mid-handoff replaces the replacing sheet with the one coming back, on top', () => {
-    render(<Flow />);
-    openFlow();
-    fireEvent.click(screen.getByRole('button', {name: 'Continue to two'}));
-    fireEvent.click(screen.getByRole('button', {name: 'Back to one'}));
-    // One was already in place: its entrance completes at once and two
-    // fades straight away, as a switcher step coming back does.
-    expect(summary()).toEqual(['Two:replaced-fading:0', 'One:replacing:0']);
-    const one = getDialog('One');
-    const two = getDialog('Two');
-    expect(one.open).toBe(true);
-    expect(two.open).toBe(true);
-    // Only one is re-shown, above two; two keeps its place, its backdrop
-    // (the scrim stays with the retained sheet) and its motion in flight.
-    expect(calls()).toEqual([
-      'showModal:One',
-      'showModal:Two',
-      'close:One',
-      'showModal:One',
-    ]);
-    expect(scrim(two)).toBe('1');
-    expect(scrim(one)).toBe('0');
-    expect(getPanel(one).style.transform).toBe('');
-    expect(document.activeElement).toBe(getPanel(one));
-    endMotion(two, 'opacity');
-    expect(summary()).toEqual(['One:top:0']);
-    expect(scrim(one)).toBe('1');
-  });
-
-  describe.each([
-    {order: 'flow order', reversed: false},
-    {order: 'reverse order', reversed: true},
-  ])('reversals with the steps written in $order', ({reversed}) => {
-    it('Back during a Continue handoff: the returning step takes over at once and the entering step fades', () => {
-      render(<Flow reversed={reversed} />);
-      openFlow();
-      fireEvent.click(screen.getByRole('button', {name: 'Continue to two'}));
-      expect(summary()).toEqual(['One:replaced-covered:0', 'Two:replacing:0']);
-      fireEvent.click(screen.getByRole('button', {name: 'Back to one'}));
-      // One was in place: the fade starts in this very update.
-      expect(summary()).toEqual(['Two:replaced-fading:0', 'One:replacing:0']);
-      expect(getDialog('One').open).toBe(true);
-      expect(getDialog('Two').open).toBe(true);
-      endMotion(getDialog('Two'), 'opacity');
-      expect(summary()).toEqual(['One:top:0']);
-      expect(openDialogs()).toEqual(['One']);
-    });
-
-    it('Continue during a Back handoff: the returning step takes over at once and the entering step fades', () => {
-      render(<Flow reversed={reversed} initialStep="two" />);
-      fireEvent.click(screen.getByRole('button', {name: 'Back to one'}));
-      expect(summary()).toEqual(['Two:replaced-covered:0', 'One:replacing:0']);
-      fireEvent.click(screen.getByRole('button', {name: 'Continue to two'}));
-      // Two was in place: it is not dropped by One's close, it comes back
-      // and One fades in this very update.
-      expect(summary()).toEqual(['One:replaced-fading:0', 'Two:replacing:0']);
-      expect(getDialog('One').open).toBe(true);
-      expect(getDialog('Two').open).toBe(true);
-      expect(document.activeElement).toBe(getPanel(getDialog('Two')));
-      endMotion(getDialog('One'), 'opacity');
-      expect(summary()).toEqual(['Two:top:0']);
-      expect(openDialogs()).toEqual(['Two']);
-    });
-
-    it('a double reversal lands on the step last chosen, with one retained sheet fading', () => {
-      render(<Flow reversed={reversed} />);
-      openFlow();
-      fireEvent.click(screen.getByRole('button', {name: 'Continue to two'}));
-      fireEvent.click(screen.getByRole('button', {name: 'Back to one'}));
-      fireEvent.click(screen.getByRole('button', {name: 'Continue to two'}));
-      expect(summary()).toEqual(['One:replaced-fading:0', 'Two:replacing:0']);
-      endMotion(getDialog('One'), 'opacity');
-      expect(summary()).toEqual(['Two:top:0']);
-    });
-  });
-
-  it('after a reversal, closing the flow still returns focus to the flow’s opener', () => {
-    render(<Flow />);
-    const opener = openFlow();
-    tap(screen.getByRole('button', {name: 'Continue to two'}));
-    tap(screen.getByRole('button', {name: 'Back to one'}));
-    endMotion(getDialog('Two'), 'opacity');
-    expect(summary()).toEqual(['One:top:0']);
-    act(() => {
-      fireEvent.keyDown(getDialog('One'), {key: 'Escape'});
-    });
-    endMotion(getDialog('One'), 'transform');
-    expect(openDialogs()).toEqual([]);
-    expect(document.activeElement).toBe(opener);
-  });
-
-  it('a third step mid-handoff drops the first step at once', () => {
-    render(<Flow />);
-    openFlow();
-    fireEvent.click(screen.getByRole('button', {name: 'Continue to two'}));
-    fireEvent.click(screen.getByRole('button', {name: 'Continue to three'}));
-    expect(getDialog('One').open).toBe(false);
-    expect(summary()).toEqual(['Two:replaced-covered:0', 'Three:replacing:0']);
-  });
-
-  it('a purpose on the replacing sheet governs dismissal', () => {
-    function Harness() {
-      const [step, setStep] = useState<'a' | 'b' | null>('a');
-      return (
-        <>
-          <BottomSheet
-            isOpen={step === 'a'}
-            onOpenChange={o => !o && setStep(null)}
-            label="A">
-            <button type="button" onClick={() => setStep('b')}>
-              Next
-            </button>
-          </BottomSheet>
-          <BottomSheet
-            isOpen={step === 'b'}
-            onOpenChange={o => !o && setStep(null)}
-            purpose="required"
-            label="B">
-            x
-          </BottomSheet>
-        </>
-      );
-    }
-    render(<Harness />);
-    fireEvent.click(screen.getByRole('button', {name: 'Next'}));
-    act(() => {
-      pressEscape();
-    });
-    expect(summary()).toEqual(['A:replaced-covered:0', 'B:replacing:0']);
-    expect(getDialog('B')).toHaveAttribute('role', 'alertdialog');
-  });
-});
-
-// ---------------------------------------------------------------------------
-// R4: the boundary — who acted, from where
-// ---------------------------------------------------------------------------
-
-/** A step flow whose step change comes from code, after a delay. */
-function Timed() {
-  const [step, setStep] = useState<Step>('one');
-  return (
-    <>
-      <BottomSheet
-        isOpen={step === 'one'}
-        onOpenChange={open => !open && setStep(null)}
-        label="One">
-        <button
-          type="button"
-          onClick={() => {
-            setTimeout(() => setStep('two'), 500);
-          }}>
-          Save and continue
-        </button>
-      </BottomSheet>
-      <BottomSheet
-        isOpen={step === 'two'}
-        onOpenChange={open => !open && setStep(null)}
-        label="Two">
-        two
-      </BottomSheet>
-    </>
-  );
-}
-
-/**
- * A flow whose middle step is an interstitial advanced by code: Submit in
- * Form opens Processing by press; Processing moves on to Done 300 ms later
- * on its own, well inside the press's freshness window.
- */
-function Interstitial({onDone}: {onDone?: () => void}) {
-  const [step, setStep] = useState<'form' | 'processing' | 'done' | null>(null);
-  return (
-    <>
-      <button type="button" onClick={() => setStep('form')}>
-        Open form
-      </button>
-      <BottomSheet
-        isOpen={step === 'form'}
-        onOpenChange={open => !open && setStep(null)}
-        label="Form">
-        <button type="button" onClick={() => setStep('processing')}>
-          Submit
-        </button>
-      </BottomSheet>
-      <BottomSheet
-        isOpen={step === 'processing'}
-        onOpenChange={open => !open && setStep(null)}
-        label="Processing">
-        <Advance onElapsed={() => setStep('done')} />
-      </BottomSheet>
-      <BottomSheet
-        isOpen={step === 'done'}
-        onOpenChange={open => !open && setStep(null)}
-        label="Done">
-        <button
-          type="button"
-          onClick={() => {
-            setStep(null);
-            onDone?.();
-          }}>
-          Close
-        </button>
-      </BottomSheet>
-    </>
-  );
-}
-
-function Advance({onElapsed}: {onElapsed: () => void}) {
-  const onElapsedRef = useRef(onElapsed);
-  onElapsedRef.current = onElapsed;
-  useEffect(() => {
-    const id = setTimeout(() => onElapsedRef.current(), 300);
-    return () => clearTimeout(id);
-  }, []);
-  return <span>Processing…</span>;
-}
-
-/**
- * `matchMedia` answering true for exactly the queries given; the rest of the
- * stub shape matches the file-level one.
- */
-function stubMedia(matching: ReadonlyArray<string>): void {
-  vi.stubGlobal(
-    'matchMedia',
-    vi.fn((query: string) => ({
-      matches: matching.includes(query),
-      media: query,
-      onchange: null,
-      addEventListener: vi.fn(),
-      removeEventListener: vi.fn(),
-      addListener: vi.fn(),
-      removeListener: vi.fn(),
-      dispatchEvent: vi.fn(),
-    })),
-  );
-}
-
-describe('BottomSheet replace: reduced motion (design:reduced-motion)', () => {
-  // The CSS itself (no transform travel, an opacity-only cross-fade of at
-  // most 200 ms on a coarse pointer, an immediate change on a fine one) is
-  // real-browser evidence; here is what ends each motion in each class.
-  it('coarse pointer (DR2): an exit ends on its opacity fade, not a transform, and a handoff still closes the retained step after its fade', () => {
-    stubMedia([REDUCED_MOTION_COARSE_QUERY]);
-    render(<Flow />);
-    openFlow();
-    const one = getDialog('One');
-    fireEvent.click(screen.getByRole('button', {name: 'Continue to two'}));
-    const two = getDialog('Two');
-    expect(summary()).toEqual(['One:replaced-covered:0', 'Two:replacing:0']);
-    // The entering transform is instant; the retained step then fades.
-    endMotion(two, 'transform');
-    expect(one).toHaveAttribute('open');
-    endMotion(one, 'opacity');
-    expect(one).not.toHaveAttribute('open');
-    expect(summary()).toEqual(['Two:top:0']);
-    // A lone exit fades out where it is: a transform end does not close it.
-    fireEvent.click(screen.getByRole('button', {name: 'Finish'}));
-    endMotion(two, 'transform');
-    expect(two).toHaveAttribute('open');
-    endMotion(two, 'opacity');
-    expect(two).not.toHaveAttribute('open');
-    expect(openDialogs()).toEqual([]);
-  });
-
-  it('the replaced sheet does not move down to a shorter entering sheet (DR1), and the handoff still ends after its fade', () => {
-    stubMedia(['(prefers-reduced-motion: reduce)']);
-    render(<Flow />);
-    openFlow();
-    const one = getDialog('One');
-    const two = getDialog('Two');
-    layoutSheet(one, 444, 400);
-    layoutSheet(two, 604, 240);
-    fireEvent.click(screen.getByRole('button', {name: 'Continue to two'}));
-    expect(summary()).toEqual(['One:replaced-aligning:0', 'Two:replacing:0']);
-    expect(getPanel(one).style.transform).toBe('');
-    endMotion(two, 'transform');
-    endMotion(one, 'transform');
-    expect(summary()).toEqual(['One:replaced-fading:0', 'Two:replacing:0']);
-    endMotion(one, 'opacity');
-    expect(summary()).toEqual(['Two:top:0']);
-  });
-
-  it('fine pointer (DR3): an exit ends on its (collapsed) transform, as without the preference', () => {
-    stubMedia(['(prefers-reduced-motion: reduce)']);
-    render(<Flow />);
-    openFlow();
-    const one = getDialog('One');
-    fireEvent.click(screen.getByRole('button', {name: 'Continue to two'}));
-    const two = getDialog('Two');
-    endMotion(two, 'transform');
-    endMotion(one, 'opacity');
-    expect(summary()).toEqual(['Two:top:0']);
-    fireEvent.click(screen.getByRole('button', {name: 'Finish'}));
-    endMotion(two, 'transform');
-    expect(two).not.toHaveAttribute('open');
-    expect(openDialogs()).toEqual([]);
-  });
-});
-
-describe('BottomSheet replace: a press is spent by the replace it made', () => {
-  it('a step advanced by code shortly after a Submit press replaces the interstitial, and the final close returns to the opener', () => {
-    vi.useFakeTimers();
-    try {
-      render(<Interstitial />);
-      const opener = screen.getByRole('button', {name: 'Open form'});
-      opener.focus();
-      fireEvent.click(opener);
-      const submit = screen.getByRole('button', {name: 'Submit'});
-      submit.focus();
-      fireEvent.click(submit);
-      // Submit's press made Form → Processing a replace…
-      expect(summary()).toEqual([
-        'Form:replaced-covered:0',
-        'Processing:replacing:0',
-      ]);
-      endMotion(getDialog('Processing'), 'transform');
-      endMotion(getDialog('Form'), 'opacity');
-      // …and is consumed by it: 300 ms later, still inside the press window,
-      // the code-driven advance is judged by focus, which is in Processing.
-      act(() => {
-        vi.advanceTimersByTime(300);
-      });
-      expect(summary()).toEqual([
-        'Processing:replaced-covered:0',
-        'Done:replacing:0',
-      ]);
-      endMotion(getDialog('Done'), 'transform');
-      endMotion(getDialog('Processing'), 'opacity');
-      fireEvent.click(screen.getByRole('button', {name: 'Close'}));
-      endMotion(getDialog('Done'), 'transform');
-      expect(openDialogs()).toEqual([]);
-      expect(opener).toHaveFocus();
-    } finally {
-      vi.useRealTimers();
-    }
-  });
-});
-
-describe('BottomSheet replace: unrelated owners', () => {
-  /**
-   * Two owners that know nothing of each other, in one tree: X owns sheet A
-   * and its opener, Y owns sheet B and its opener. A page control closes A
-   * and opens B in one update.
-   */
-  function TwoOwners() {
-    const [isAOpen, setIsAOpen] = useState(false);
-    const [isBOpen, setIsBOpen] = useState(false);
-    return (
-      <>
-        <button type="button" onClick={() => setIsAOpen(true)}>
-          Open A
-        </button>
-        <button type="button" onClick={() => setIsBOpen(true)}>
-          Open B
-        </button>
-        <button
-          type="button"
-          onClick={() => {
-            setIsAOpen(false);
-            setIsBOpen(true);
-          }}>
-          Swap from page
-        </button>
-        <BottomSheet isOpen={isAOpen} onOpenChange={setIsAOpen} label="A">
-          <button
-            type="button"
-            onClick={() => {
-              setIsAOpen(false);
-              setIsBOpen(true);
-            }}>
-            Swap from A
-          </button>
-        </BottomSheet>
-        <BottomSheet isOpen={isBOpen} onOpenChange={setIsBOpen} label="B">
-          <button type="button" onClick={() => setIsBOpen(false)}>
-            Close B
-          </button>
-        </BottomSheet>
-      </>
-    );
-  }
-
-  it('a close and an open driven from a control outside the closing sheet are a pop and a push, each with its own opener', () => {
-    render(<TwoOwners />);
-    const openA = screen.getByRole('button', {name: 'Open A'});
-    openA.focus();
-    fireEvent.click(openA);
-    const swap = screen.getByRole('button', {name: 'Swap from page'});
-    swap.focus();
-    fireEvent.click(swap);
-    // Not a replace: A slides out beneath B, B is a fresh push.
-    expect(summary()).toEqual(['A:exiting:1', 'B:top:0']);
-    expect(getDialog('A')).toHaveAttribute('data-sheet-stack', 'exiting');
-    expect(getDialog('A')).not.toHaveAttribute('data-sheet-stack', 'replaced');
-    endMotion(getDialog('A'), 'transform');
-    expect(summary()).toEqual(['B:top:0']);
-    // B's opener is its own (the control that opened it), not A's.
-    fireEvent.click(screen.getByRole('button', {name: 'Close B'}));
-    endMotion(getDialog('B'), 'transform');
-    expect(swap).toHaveFocus();
-    expect(openA).not.toHaveFocus();
-  });
-
-  it('the same close and open driven from inside the closing sheet are a replace', () => {
-    render(<TwoOwners />);
-    const openA = screen.getByRole('button', {name: 'Open A'});
-    openA.focus();
-    fireEvent.click(openA);
-    // Focus is in A (its panel took it on open).
-    fireEvent.click(screen.getByRole('button', {name: 'Swap from A'}));
-    expect(summary()).toEqual(['A:replaced-covered:0', 'B:replacing:0']);
-    endMotion(getDialog('B'), 'transform');
-    endMotion(getDialog('A'), 'opacity');
-    fireEvent.click(screen.getByRole('button', {name: 'Close B'}));
-    endMotion(getDialog('B'), 'transform');
-    // The flow began at A's opener, so that is where it returns.
-    expect(openA).toHaveFocus();
-  });
-
-  it('reads the press, not focus: a tap inside the closing sheet replaces even when nothing in it is focused', () => {
-    render(<TwoOwners />);
-    const openA = screen.getByRole('button', {name: 'Open A'});
-    openA.focus();
-    fireEvent.click(openA);
-    // Focus leaves the sheet (a browser that does not focus clicked buttons,
-    // or the person tabbed out); the tap still comes from inside A.
-    document.body.focus();
-    tap(screen.getByRole('button', {name: 'Swap from A'}));
-    expect(summary()).toEqual(['A:replaced-covered:0', 'B:replacing:0']);
-  });
-
-  it('reads the press, not focus: a tap outside the closing sheet is not a replace even with focus still inside it', () => {
-    render(<TwoOwners />);
-    fireEvent.click(screen.getByRole('button', {name: 'Open A'}));
-    expect(document.activeElement).toBe(getPanel(getDialog('A')));
-    // Focus is in A's panel (it took it on open); the press is on the page.
-    tap(screen.getByRole('button', {name: 'Swap from page'}));
-    expect(summary()).toEqual(['A:exiting:1', 'B:top:0']);
-  });
-
-  it('a step flow whose steps are wrapped in their own components still replaces', () => {
-    function Step({
-      name,
-      step,
-      setStep,
-      next,
-    }: {
-      name: Step;
-      step: Step;
-      setStep: (step: Step) => void;
-      next: Step;
-    }) {
-      return (
-        <div>
-          <BottomSheet
-            isOpen={step === name}
-            onOpenChange={open => !open && setStep(null)}
-            label={String(name)}>
-            <button type="button" onClick={() => setStep(next)}>
-              Go to {next}
-            </button>
-          </BottomSheet>
-        </div>
-      );
-    }
-    function Wizard() {
-      const [step, setStep] = useState<Step>(null);
-      return (
-        <>
-          <button type="button" onClick={() => setStep('one')}>
-            Start
-          </button>
-          <Step name="one" step={step} setStep={setStep} next="two" />
-          <Step name="two" step={step} setStep={setStep} next="three" />
-          <Step name="three" step={step} setStep={setStep} next={null} />
-        </>
-      );
-    }
-    render(<Wizard />);
-    const start = screen.getByRole('button', {name: 'Start'});
-    start.focus();
-    fireEvent.click(start);
-    fireEvent.click(screen.getByRole('button', {name: 'Go to two'}));
-    expect(summary()).toEqual(['one:replaced-covered:0', 'two:replacing:0']);
-    endMotion(getDialog('two'), 'transform');
-    endMotion(getDialog('one'), 'opacity');
-    fireEvent.click(screen.getByRole('button', {name: 'Go to three'}));
-    expect(summary()).toEqual(['two:replaced-covered:0', 'three:replacing:0']);
-    endMotion(getDialog('three'), 'transform');
-    endMotion(getDialog('two'), 'opacity');
-    fireEvent.click(screen.getByRole('button', {name: 'Go to'}));
-    endMotion(getDialog('three'), 'transform');
-    expect(openDialogs()).toEqual([]);
-    expect(start).toHaveFocus();
-  });
-
-  it('a step change made by code while focus is in the step is a replace (focus cannot be anywhere else under a modal sheet)', () => {
-    vi.useFakeTimers();
-    try {
-      render(<Timed />);
-      fireEvent.click(screen.getByRole('button', {name: 'Save and continue'}));
-      act(() => {
-        vi.advanceTimersByTime(500);
-      });
-      expect(summary()).toEqual(['One:replaced-covered:0', 'Two:replacing:0']);
-    } finally {
-      vi.useRealTimers();
-    }
-  });
-
-  it('a press only counts while fresh: an old key press elsewhere does not veto a later replace', () => {
-    vi.useFakeTimers();
-    try {
-      render(<Timed />);
-      // A key pressed on the page a while ago (its target is outside the
-      // sheet); then the sheet's own control, by code, moves the flow on.
-      fireEvent.keyDown(document.body, {key: 'Shift'});
-      act(() => {
-        vi.advanceTimersByTime(1500);
-      });
-      fireEvent.click(screen.getByRole('button', {name: 'Save and continue'}));
-      act(() => {
-        vi.advanceTimersByTime(500);
-      });
-      expect(summary()).toEqual(['One:replaced-covered:0', 'Two:replacing:0']);
-    } finally {
-      vi.useRealTimers();
-    }
-  });
-});
-
-// ---------------------------------------------------------------------------
-// R5: non-modal sheets take no part
-// ---------------------------------------------------------------------------
-
-describe('BottomSheet replace: several sheets changing in one update', () => {
-  // A open; B opened from A; a control in B closes A and B and opens C in one
-  // handler. Two closes and one open is not a replace, whichever order the
-  // sheets are written in — the pairing is decided by the commit's final
-  // tally, not by which flips the registry heard first.
-  function ThreeSheets({order}: {order: 'ABC' | 'CBA'}) {
-    const [isAOpen, setIsAOpen] = useState(false);
-    const [isBOpen, setIsBOpen] = useState(false);
-    const [isCOpen, setIsCOpen] = useState(false);
-    const a = (
-      <BottomSheet key="A" isOpen={isAOpen} onOpenChange={setIsAOpen} label="A">
-        <button type="button" onClick={() => setIsBOpen(true)}>
-          Open B
-        </button>
-      </BottomSheet>
-    );
-    const b = (
-      <BottomSheet key="B" isOpen={isBOpen} onOpenChange={setIsBOpen} label="B">
-        <button
-          type="button"
-          onClick={() => {
-            setIsAOpen(false);
-            setIsBOpen(false);
-            setIsCOpen(true);
-          }}>
-          Finish to C
-        </button>
-      </BottomSheet>
-    );
-    const c = (
-      <BottomSheet key="C" isOpen={isCOpen} onOpenChange={setIsCOpen} label="C">
-        <button type="button" onClick={() => setIsCOpen(false)}>
-          Close C
-        </button>
-      </BottomSheet>
-    );
-    return (
-      <>
-        <button type="button" onClick={() => setIsAOpen(true)}>
-          Open A
-        </button>
-        {order === 'ABC' ? [a, b, c] : [c, b, a]}
-      </>
-    );
-  }
-
-  for (const order of ['ABC', 'CBA'] as const) {
-    it(`two closes and one open from inside the top sheet are a pop, a pop and a push, written ${order}`, () => {
-      render(<ThreeSheets order={order} />);
-      const openA = screen.getByRole('button', {name: 'Open A'});
-      openA.focus();
-      fireEvent.click(openA);
-      fireEvent.click(screen.getByRole('button', {name: 'Open B'}));
-      expect(summary()).toEqual(['A:covered:1', 'B:top:0']);
-      fireEvent.click(screen.getByRole('button', {name: 'Finish to C'}));
-      // Neither A nor B is replaced; C is a fresh push above the two exits.
-      expect(getDialog('A')).toHaveAttribute('data-sheet-stack', 'exiting');
-      expect(getDialog('B')).toHaveAttribute('data-sheet-stack', 'exiting');
-      expect(getDialog('C')).toHaveAttribute('data-sheet-stack', 'top');
-      expect(getDialog('A')).not.toHaveAttribute(
-        'data-sheet-stack',
-        'replaced',
-      );
-      expect(getDialog('B')).not.toHaveAttribute(
-        'data-sheet-stack',
-        'replaced',
-      );
-      endMotion(getDialog('B'), 'transform');
-      endMotion(getDialog('A'), 'transform');
-      expect(summary()).toEqual(['C:top:0']);
-      // C's opener is its own (the control in B that opened it is gone with
-      // B), so closing C does not land on A's opener as a replace would.
-      fireEvent.click(screen.getByRole('button', {name: 'Close C'}));
-      endMotion(getDialog('C'), 'transform');
-      expect(openA).not.toHaveFocus();
-    });
-  }
-
-  it('a pair made early in a commit is undone by a third flip in the same commit', () => {
-    // Same scenario, driven so the registry hears B's close and C's open
-    // before A's close: the pair is made and then undone before paint.
-    render(<ThreeSheets order="CBA" />);
-    fireEvent.click(screen.getByRole('button', {name: 'Open A'}));
-    fireEvent.click(screen.getByRole('button', {name: 'Open B'}));
-    fireEvent.click(screen.getByRole('button', {name: 'Finish to C'}));
-    expect(getDialog('B')).not.toHaveAttribute('data-sheet-stack', 'replaced');
-    expect(getDialog('C')).not.toHaveAttribute('data-sheet-stack', 'replacing');
-    const state = getBottomSheetStackForTests();
-    expect(state.filter(entry => entry.view.isReplacing)).toHaveLength(0);
-    expect(
-      state.filter(entry => entry.view.replacedMotion != null),
-    ).toHaveLength(0);
-  });
-});
-
-describe('BottomSheet replace: non-modal sheets', () => {
-  it('non-modal sheets are manual popovers that replace each other without stacking', () => {
-    render(<Flow hasScrim={false} />);
-    openFlow();
-    expect(calls()).toEqual(['showPopover:One']);
-    expect(getDialog('One')).toHaveAttribute('popover', 'manual');
-    // Not a stack level: no modal group entry, no stack attributes, no scrim.
-    expect(getBottomSheetStackForTests()).toEqual([]);
-    expect(getDialog('One')).not.toHaveAttribute('data-sheet-stack');
-    expect(scrim(getDialog('One'))).toBe('');
-    tap(screen.getByRole('button', {name: 'Continue to two'}));
-    // The same handoff as a modal replace, on the non-modal group.
-    expect(
-      getBottomSheetStackForTests(document, false).map(({element, view}) =>
-        [
-          element?.getAttribute('aria-label'),
-          view.replacedMotion ?? (view.isReplacing ? 'replacing' : 'idle'),
-        ].join(':'),
-      ),
-    ).toEqual(['One:covered', 'Two:replacing']);
-    expect(calls()).toEqual(['showPopover:One', 'showPopover:Two']);
-    const one = getDialog('One');
-    const two = getDialog('Two');
-    expect(one).toHaveAttribute('inert');
-    expect(one).toHaveAttribute('aria-hidden', 'true');
-    expect(two).not.toHaveAttribute('aria-modal');
-    expect(getPanel(one).className).not.toContain('sheetClosing');
-    // No stack attributes and no z-index band on either dialog.
-    expect(one).not.toHaveAttribute('data-sheet-stack');
-    expect(two).not.toHaveAttribute('data-sheet-stack');
-    endMotion(two, 'transform');
-    endMotion(one, 'opacity');
-    expect(openDialogs()).toEqual(['Two']);
-    expect(calls()).toEqual([
-      'showPopover:One',
-      'showPopover:Two',
-      'hidePopover:One',
-    ]);
-    // The page stayed interactive: no scroll lock, no focus steal.
-    expect(document.body.style.position).not.toBe('fixed');
-  });
-
-  it('a non-modal reversal re-shows the returning sheet above the other', () => {
-    render(<Flow hasScrim={false} initialStep="two" />);
-    tap(screen.getByRole('button', {name: 'Back to one'}));
-    tap(screen.getByRole('button', {name: 'Continue to two'}));
-    expect(
-      getBottomSheetStackForTests(document, false).map(({element, view}) =>
-        [
-          element?.getAttribute('aria-label'),
-          view.replacedMotion ?? (view.isReplacing ? 'replacing' : 'idle'),
-        ].join(':'),
-      ),
-    ).toEqual(['One:fading', 'Two:replacing']);
-    expect(calls().slice(-2)).toEqual(['hidePopover:Two', 'showPopover:Two']);
-  });
-
-  it('a non-modal flow returns focus to its opener when its last step closes', () => {
-    render(<Flow hasScrim={false} />);
-    const opener = openFlow();
-    const next = screen.getByRole('button', {name: 'Continue to two'});
-    next.focus();
-    tap(next);
-    const one = getDialog('One');
-    const two = getDialog('Two');
-    endMotion(two, 'transform');
-    endMotion(one, 'opacity');
-    const finish = screen.getByRole('button', {name: 'Finish'});
-    finish.focus();
-    fireEvent.click(finish);
-    endMotion(two, 'transform');
-    expect(openDialogs()).toEqual([]);
-    expect(document.activeElement).toBe(opener);
-  });
-
-  describe('with a showPopover() that does not move focus (Safari)', () => {
-    let showPopover: typeof HTMLElement.prototype.showPopover;
-    beforeEach(() => {
-      showPopover = HTMLElement.prototype.showPopover;
-      HTMLElement.prototype.showPopover = vi.fn(function (this: HTMLElement) {
-        nativeLog.push({call: 'showPopover', dialog: this});
-        this.setAttribute('open', '');
-      });
-    });
-    afterEach(() => {
-      HTMLElement.prototype.showPopover = showPopover;
-    });
-
-    it('a non-modal replace moves focus into the entering step and the final close returns it to the opener', () => {
-      render(<Flow hasScrim={false} />);
-      const opener = openFlow();
-      // A lone non-modal sheet takes no focus on open.
-      expect(document.activeElement).toBe(opener);
-      const next = screen.getByRole('button', {name: 'Continue to two'});
-      next.focus();
-      tap(next);
-      const one = getDialog('One');
-      const two = getDialog('Two');
-      // The person was in step one; the entering step takes focus even
-      // though the browser moved nothing.
-      expect(document.activeElement).toBe(getPanel(two));
-      endMotion(two, 'transform');
-      endMotion(one, 'opacity');
-      expect(document.activeElement).toBe(getPanel(two));
-      const finish = screen.getByRole('button', {name: 'Finish'});
-      finish.focus();
-      fireEvent.click(finish);
-      endMotion(two, 'transform');
-      expect(openDialogs()).toEqual([]);
-      expect(document.activeElement).toBe(opener);
-    });
-
-    it('a non-modal reversal moves focus into the returning step', () => {
-      render(<Flow hasScrim={false} initialStep="two" />);
-      const back = screen.getByRole('button', {name: 'Back to one'});
-      back.focus();
-      tap(back);
-      expect(document.activeElement).toBe(getPanel(getDialog('One')));
-      const forward = screen.getByRole('button', {name: 'Continue to two'});
-      forward.focus();
-      tap(forward);
-      expect(document.activeElement).toBe(getPanel(getDialog('Two')));
-    });
-
-    it('two non-modal owners swapped from a page control keep focus on the page (not a replace)', () => {
-      function TwoNonModalOwners() {
-        const [isAOpen, setIsAOpen] = useState(true);
-        const [isBOpen, setIsBOpen] = useState(false);
-        return (
-          <>
-            <button
-              type="button"
-              onClick={() => {
-                setIsAOpen(false);
-                setIsBOpen(true);
-              }}>
-              Swap from page
-            </button>
-            <BottomSheet
-              isOpen={isAOpen}
-              onOpenChange={setIsAOpen}
-              hasScrim={false}
-              label="A">
-              a
-            </BottomSheet>
-            <BottomSheet
-              isOpen={isBOpen}
-              onOpenChange={setIsBOpen}
-              hasScrim={false}
-              label="B">
-              b
-            </BottomSheet>
-          </>
-        );
-      }
-      render(<TwoNonModalOwners />);
-      const swap = screen.getByRole('button', {name: 'Swap from page'});
-      swap.focus();
-      tap(swap);
-      // Pop and push, not a replace: B is a lone non-modal sheet opening and
-      // takes no focus; the person stays on the page control.
-      expect(
-        getBottomSheetStackForTests(document, false).some(
-          ({view}) => view.isReplacing || view.replacedMotion != null,
-        ),
-      ).toBe(false);
-      expect(document.activeElement).toBe(swap);
-    });
-  });
-
-  it('a non-modal sheet never pairs with a modal one', () => {
-    function Harness() {
-      const [step, setStep] = useState<'a' | 'b'>('a');
-      return (
-        <>
-          <BottomSheet
-            isOpen={step === 'a'}
-            onOpenChange={() => {}}
-            hasScrim={false}
-            label="A">
-            <button type="button" onClick={() => setStep('b')}>
-              Next
-            </button>
-          </BottomSheet>
-          <BottomSheet isOpen={step === 'b'} onOpenChange={() => {}} label="B">
-            x
-          </BottomSheet>
-        </>
-      );
-    }
-    render(<Harness />);
-    tap(screen.getByRole('button', {name: 'Next'}));
-    expect(summary()).toEqual(['B:top:0']);
-    expect(getDialog('A')).not.toHaveAttribute('data-sheet-stack');
-    expect(getPanel(getDialog('A')).className).toContain('sheetClosing');
-    expect(calls()).toEqual(['showPopover:A', 'showModal:B']);
-  });
-
-  it('falls back to show() and still replaces below the Popover API support floor', () => {
-    const showPopover = HTMLElement.prototype.showPopover;
-    const hidePopover = HTMLElement.prototype.hidePopover;
-    // @ts-expect-error -- emulate a browser without the Popover API
-    delete HTMLElement.prototype.showPopover;
-    // @ts-expect-error -- emulate a browser without the Popover API
-    delete HTMLElement.prototype.hidePopover;
-    try {
-      render(<Flow hasScrim={false} />);
-      openFlow();
-      tap(screen.getByRole('button', {name: 'Continue to two'}));
-      expect(calls()).toEqual(['show:One', 'show:Two']);
-      endMotion(getDialog('Two'), 'transform');
-      endMotion(getDialog('One'), 'opacity');
-      expect(calls()).toEqual(['show:One', 'show:Two', 'close:One']);
-      expect(openDialogs()).toEqual(['Two']);
-    } finally {
-      HTMLElement.prototype.showPopover = showPopover;
-      HTMLElement.prototype.hidePopover = hidePopover;
-    }
-  });
-});