@octanejs/base-ui 0.1.49 → 0.1.51

package/src/drawer/viewport/DrawerViewport.tsrx

@@ -0,0 +1,1237 @@
+'use client';
+import * as React from 'octane';
+import * as ReactDOM from 'octane';
+import { isElement } from '@floating-ui/utils/dom';
+import { addEventListener } from '@octanejs/base-ui-utils/addEventListener';
+import { ownerDocument, ownerWindow } from '@octanejs/base-ui-utils/owner';
+import { useAnimationFrame } from '@octanejs/base-ui-utils/useAnimationFrame';
+import { useIsoLayoutEffect } from '@octanejs/base-ui-utils/useIsoLayoutEffect';
+import { useStableCallback } from '@octanejs/base-ui-utils/useStableCallback';
+import { clamp } from '@octanejs/base-ui-utils/clamp';
+import { useDialogRootContext } from '../../dialog/root/DialogRootContext';
+import { DialogViewport } from '../../dialog/viewport/DialogViewport.tsrx';
+import * as DialogViewportDataAttributes from '../../dialog/viewport/DialogViewportDataAttributes';
+import { mergeProps } from '../../merge-props';
+import { useDrawerRootContext } from '../root/DrawerRootContext';
+import {
+	closestSnapPointIndex,
+	getSnapPointSwipeMovement,
+	useDrawerSnapPoints,
+	type ResolvedDrawerSnapPoint,
+} from '../root/useDrawerSnapPoints';
+import { useDrawerProviderContext } from '../provider/DrawerProviderContext';
+import {
+	getDisplacement,
+	useSwipeDismiss,
+	type SwipeDirection,
+	type UseSwipeDismissProgressDetails,
+} from '../../utils/useSwipeDismiss';
+import * as DrawerPopupCssVars from '../popup/DrawerPopupCssVars';
+import * as DrawerPopupDataAttributes from '../popup/DrawerPopupDataAttributes';
+import * as DrawerBackdropCssVars from '../backdrop/DrawerBackdropCssVars';
+import { DRAWER_CONTENT_ATTRIBUTE } from '../content/drawerContentAttribute';
+import { REASONS } from '../../internals/reasons';
+import { createChangeEventDetails } from '../../internals/createBaseUIEventDetails';
+import { activeElement, contains, getTarget } from '../../floating-ui-react/utils';
+import { DrawerViewportContext } from './DrawerViewportContext.tsrx';
+import { TransitionStatusDataAttributes } from '../../internals/stateAttributesMapping';
+import { findScrollableTouchTarget, type ScrollAxis } from '../../utils/scrollable';
+import { BASE_UI_SWIPE_IGNORE_SELECTOR } from '../../internals/constants';
+import { getElementAtPoint } from '../../utils/getElementAtPoint';
+import type { BaseUIComponentProps } from '../../internals/types';
+import type { TransitionStatus } from '../../internals/useTransitionStatus';
+import { useDrawerVirtualKeyboardContext } from '../virtual-keyboard-provider/DrawerVirtualKeyboardContext.tsrx';
+
+const MIN_SWIPE_THRESHOLD = 10;
+const FAST_SWIPE_VELOCITY = 0.5;
+const SNAP_VELOCITY_THRESHOLD = 0.5;
+const SNAP_VELOCITY_MULTIPLIER = 300;
+const MAX_SNAP_VELOCITY = 4;
+const MIN_SWIPE_RELEASE_VELOCITY = 0.2;
+const MAX_SWIPE_RELEASE_VELOCITY = 4;
+const MIN_SWIPE_RELEASE_DURATION_MS = 80;
+const MAX_SWIPE_RELEASE_DURATION_MS = 360;
+const MIN_SWIPE_RELEASE_SCALAR = 0.1;
+const MAX_SWIPE_RELEASE_SCALAR = 1;
+const AXIS_LOCK_SLOP = 6;
+const AXIS_LOCK_BIAS = 2;
+const DRAWER_CONTENT_SELECTOR = `[${DRAWER_CONTENT_ATTRIBUTE}]`;
+
+interface TouchScrollState {
+	startX: number;
+	startY: number;
+	lastX: number;
+	lastY: number;
+	scrollTarget: HTMLElement | null;
+	hasCrossAxisScrollableContent: boolean;
+	allowSwipe: boolean | null;
+	preserveNativeCrossAxisScroll: boolean;
+	drawerAxisAttributed: boolean;
+}
+
+/**
+ * A positioning container for the drawer popup that can be made scrollable.
+ * Renders a `<div>` element.
+ *
+ * Documentation: [Base UI Drawer](https://base-ui.com/react/components/drawer)
+ */
+export const DrawerViewport = function DrawerViewport(
+	propsWithRef: React.PropsWithoutRef<DrawerViewport.Props> & { ref?: React.Ref<HTMLDivElement> },
+) {
+	const { ref: forwardedRef = null, ...props } = propsWithRef;
+	const { render, className, style, children, ...elementProps } = props;
+
+	const store = useDialogRootContext();
+	const popupRef = store.context.popupRef;
+	const backdropRef = store.context.backdropRef;
+
+	const {
+		swipeDirection,
+		notifyParentSwipingChange,
+		notifyParentSwipeProgressChange,
+		frontmostHeight,
+		snapToSequentialPoints,
+		swipeAreaActiveRef,
+	} = useDrawerRootContext();
+	const providerContext = useDrawerProviderContext();
+	const {
+		snapPoints,
+		resolvedSnapPoints,
+		activeSnapPoint,
+		activeSnapPointOffset,
+		setActiveSnapPoint,
+		popupHeight,
+	} = useDrawerSnapPoints();
+
+	const open = store.useState('open');
+	const mounted = store.useState('mounted');
+	const nested = store.useState('nested');
+	const nestedOpenDrawerCount = store.useState('nestedOpenDrawerCount');
+	const viewportElement = store.useState('viewportElement');
+	const popupElementState = store.useState('popupElement');
+
+	const visualStateStore = providerContext?.visualStateStore;
+	const nestedDrawerOpen = nestedOpenDrawerCount > 0;
+	const scrollAxis =
+		swipeDirection === 'left' || swipeDirection === 'right' ? 'horizontal' : 'vertical';
+	const isVerticalScrollAxis = scrollAxis === 'vertical';
+	const crossScrollAxis: ScrollAxis = isVerticalScrollAxis ? 'horizontal' : 'vertical';
+
+	const [swipeRelease, setSwipeRelease] = React.useState<number | null>(null);
+
+	const pendingSwipeCloseSnapPointRef = React.useRef<typeof activeSnapPoint | undefined>(undefined);
+	const resetSwipeRef = React.useRef<(() => void) | null>(null);
+	const controlledDismissFrame = useAnimationFrame();
+
+	const swipingRef = React.useRef(false);
+	const nestedSwipeActiveRef = React.useRef(false);
+	const lastPointerTypeRef = React.useRef<React.PointerEvent['pointerType'] | ''>('');
+	const ignoreNextTouchStartFromPenRef = React.useRef(false);
+	const ignoreTouchSwipeRef = React.useRef(false);
+	const touchScrollStateRef = React.useRef<TouchScrollState | null>(null);
+
+	const virtualKeyboard = useDrawerVirtualKeyboardContext();
+
+	const snapPointRange = React.useMemo(() => {
+		if (
+			!snapPoints ||
+			snapPoints.length < 2 ||
+			resolvedSnapPoints.length < 2 ||
+			(swipeDirection !== 'down' && swipeDirection !== 'up')
+		) {
+			return null;
+		}
+
+		const offsets = resolvedSnapPoints.map((point) => point.offset).sort((a, b) => a - b);
+
+		const minOffset = offsets[0];
+		const nextOffset = offsets[1];
+		const range = nextOffset - minOffset;
+
+		return { minOffset, range };
+	}, [resolvedSnapPoints, snapPoints, swipeDirection]);
+
+	const snapPointProgress = React.useMemo(() => {
+		if (!snapPointRange || activeSnapPointOffset === null) {
+			return null;
+		}
+
+		return clamp((activeSnapPointOffset - snapPointRange.minOffset) / snapPointRange.range, 0, 1);
+	}, [activeSnapPointOffset, snapPointRange]);
+
+	const swipeDirections = React.useMemo<SwipeDirection[]>(() => {
+		if (
+			snapPoints &&
+			snapPoints.length > 0 &&
+			(swipeDirection === 'down' || swipeDirection === 'up')
+		) {
+			return swipeDirection === 'down' ? ['down', 'up'] : ['up', 'down'];
+		}
+
+		return [swipeDirection];
+	}, [snapPoints, swipeDirection]);
+
+	const setSwipeDismissed = useStableCallback((dismissed: boolean) => {
+		popupRef.current?.toggleAttribute(DrawerPopupDataAttributes.swipeDismiss, dismissed);
+		backdropRef.current?.toggleAttribute(DrawerPopupDataAttributes.swipeDismiss, dismissed);
+	});
+
+	const clearSwipeRelease = useStableCallback(() => {
+		setSwipeDismissed(false);
+		popupRef.current?.removeAttribute(TransitionStatusDataAttributes.endingStyle);
+		setSwipeRelease(null);
+	});
+
+	const finishNestedSwipe = useStableCallback(() => {
+		if (!nestedSwipeActiveRef.current) {
+			return;
+		}
+
+		nestedSwipeActiveRef.current = false;
+		notifyParentSwipingChange?.(false);
+	});
+
+	const applySwipeProgress = useStableCallback(
+		(resolvedProgress: number, shouldTrackProgress: boolean, notifyParent: boolean) => {
+			const isActive = open && !nested && shouldTrackProgress;
+			const swipeProgress = isActive ? resolvedProgress : 0;
+			const nestedSwipeProgress = open && shouldTrackProgress ? resolvedProgress : 0;
+
+			if (notifyParent && notifyParentSwipeProgressChange) {
+				notifyParentSwipeProgressChange(nestedSwipeProgress);
+
+				if (nestedSwipeProgress <= 0) {
+					finishNestedSwipe();
+				}
+			}
+
+			visualStateStore?.set({
+				swipeProgress,
+				frontmostHeight: swipeProgress > 0 ? frontmostHeight : 0,
+			});
+
+			const backdropElement = backdropRef.current;
+			if (!backdropElement) {
+				return;
+			}
+
+			const showProgress = isActive && swipeProgress > 0;
+			backdropElement.style.setProperty(
+				DrawerBackdropCssVars.swipeProgress,
+				showProgress ? `${swipeProgress}` : '0',
+			);
+			if (showProgress && frontmostHeight > 0) {
+				backdropElement.style.setProperty(DrawerPopupCssVars.height, `${frontmostHeight}px`);
+			} else {
+				backdropElement.style.removeProperty(DrawerPopupCssVars.height);
+			}
+		},
+	);
+
+	function resolveSwipeRelease(
+		popupElement: HTMLElement,
+		direction: SwipeDirection,
+		deltaX: number,
+		deltaY: number,
+		velocityX: number,
+		velocityY: number,
+		releaseVelocityX: number,
+		releaseVelocityY: number,
+	): number | null {
+		const size = getBaseSwipeSize(popupElement, direction);
+		if (size <= 0) {
+			return null;
+		}
+
+		// The snap point base offset shifts the popup along the dismiss direction for both
+		// `down` (+offset) and `up` (-offset), so it always adds to the directional translation.
+		const snapPointBaseOffset =
+			(direction === 'down' || direction === 'up') && snapPoints && snapPoints.length > 0
+				? (activeSnapPointOffset ?? 0)
+				: 0;
+		const translationAlongDirection =
+			snapPointBaseOffset + getDisplacement(direction, deltaX, deltaY);
+		const remainingDistance = Math.max(0, size - translationAlongDirection);
+		if (remainingDistance <= 0) {
+			return null;
+		}
+
+		const releaseVelocity = getDisplacement(direction, releaseVelocityX, releaseVelocityY);
+		const directionalVelocity =
+			Math.abs(releaseVelocity) > 0
+				? releaseVelocity
+				: getDisplacement(direction, velocityX, velocityY);
+		if (directionalVelocity <= MIN_SWIPE_RELEASE_VELOCITY) {
+			return null;
+		}
+
+		const clampedVelocity = clamp(
+			directionalVelocity,
+			MIN_SWIPE_RELEASE_VELOCITY,
+			MAX_SWIPE_RELEASE_VELOCITY,
+		);
+		// The gesture hook supplies finite deltas and velocities. The guards above keep the remaining
+		// distance and divisor positive, so the duration stays within [MIN, MAX] and the resulting
+		// scalar within (0, 1].
+		const durationMs = clamp(
+			remainingDistance / clampedVelocity,
+			MIN_SWIPE_RELEASE_DURATION_MS,
+			MAX_SWIPE_RELEASE_DURATION_MS,
+		);
+		const normalizedDuration =
+			(durationMs - MIN_SWIPE_RELEASE_DURATION_MS) /
+			(MAX_SWIPE_RELEASE_DURATION_MS - MIN_SWIPE_RELEASE_DURATION_MS);
+		return (
+			MIN_SWIPE_RELEASE_SCALAR +
+			normalizedDuration * (MAX_SWIPE_RELEASE_SCALAR - MIN_SWIPE_RELEASE_SCALAR)
+		);
+	}
+
+	function updateNestedSwipeActive(details?: UseSwipeDismissProgressDetails) {
+		if (nestedSwipeActiveRef.current || !details) {
+			return;
+		}
+
+		const direction = details.direction ?? swipeDirection;
+		const delta = getDisplacement(direction, details.deltaX, details.deltaY);
+		if (Math.abs(delta) < MIN_SWIPE_THRESHOLD) {
+			return;
+		}
+
+		nestedSwipeActiveRef.current = true;
+		notifyParentSwipingChange?.(true);
+	}
+
+	const swipe = useSwipeDismiss({
+		enabled: mounted && !nestedDrawerOpen,
+		directions: swipeDirections,
+		elementRef: store.context.popupRef,
+		ignoreSelectorWhenTouch: false,
+		ignoreScrollableAncestors: true,
+		movementCssVars: {
+			x: DrawerPopupCssVars.swipeMovementX,
+			y: DrawerPopupCssVars.swipeMovementY,
+		},
+		onSwipeStart(event) {
+			if ('touches' in event || event.pointerType === 'touch') {
+				return;
+			}
+
+			const popupElement = popupRef.current;
+
+			const doc = ownerDocument(popupElement);
+			const selection = doc.getSelection?.();
+			if (!selection || selection.isCollapsed) {
+				return;
+			}
+
+			const anchorElement = isElement(selection.anchorNode)
+				? selection.anchorNode
+				: selection.anchorNode?.parentElement;
+			const focusElement = isElement(selection.focusNode)
+				? selection.focusNode
+				: selection.focusNode?.parentElement;
+
+			if (!contains(popupElement, anchorElement) && !contains(popupElement, focusElement)) {
+				return;
+			}
+
+			selection.removeAllRanges();
+		},
+		onSwipingChange(swiping) {
+			swipingRef.current = swiping;
+			setBackdropSwipingAttribute(store.context.backdropRef.current, swiping);
+
+			if (!swiping && !notifyParentSwipeProgressChange) {
+				finishNestedSwipe();
+			}
+		},
+		swipeThreshold({ element, direction }) {
+			return getBaseSwipeThreshold(element, direction);
+		},
+		canStart(position, details) {
+			const popupElement = store.context.popupRef.current;
+			if (!popupElement) {
+				return false;
+			}
+
+			const doc = popupElement.ownerDocument;
+			const elementAtPoint = getElementAtPoint(popupElement.getRootNode(), position.x, position.y);
+			if (!elementAtPoint || !contains(popupElement, elementAtPoint)) {
+				return false;
+			}
+
+			const nativeEvent = details.nativeEvent;
+			const touchLike = 'touches' in nativeEvent || nativeEvent.pointerType === 'touch';
+			if (touchLike && shouldIgnoreSwipeForTextSelection(doc, popupElement)) {
+				return false;
+			}
+
+			return true;
+		},
+		onProgress(progress, details) {
+			const swiping = swipingRef.current;
+
+			if (swiping) {
+				updateNestedSwipeActive(details);
+			}
+
+			const hasSnapPoints = Boolean(snapPoints && snapPoints.length > 0);
+			if (swiping && swipeDirection === 'down' && hasSnapPoints && details) {
+				const popupElement = store.context.popupRef.current;
+				if (popupElement) {
+					popupElement.style.removeProperty('transform');
+					popupElement.style.setProperty(
+						DrawerPopupCssVars.swipeMovementY,
+						`${getSnapPointSwipeMovement(activeSnapPointOffset ?? 0, details.deltaY)}px`,
+					);
+				}
+			}
+
+			let resolvedProgress = progress;
+			if (snapPointRange && popupHeight > 0) {
+				const baseOffset = activeSnapPointOffset ?? snapPointRange.minOffset;
+				const offsetToProgress = (nextOffset: number) =>
+					clamp((nextOffset - snapPointRange.minOffset) / snapPointRange.range, 0, 1);
+
+				// Outside a drag the hook still reports the last drag deltas, both after a release and
+				// on a gesture that never started (e.g. a press inside `Drawer.Content`). Recomputing
+				// from them would re-apply drag progress to a drawer that rests on its snap point.
+				if (swiping && details && Number.isFinite(details.deltaY)) {
+					resolvedProgress = offsetToProgress(clamp(baseOffset + details.deltaY, 0, popupHeight));
+				} else if (snapPointProgress !== null) {
+					resolvedProgress = snapPointProgress;
+				}
+			}
+
+			// A parent drawer follows an active drag only, so drop it back to zero once the drag ends.
+			if (!swiping) {
+				notifyParentSwipeProgressChange?.(0);
+				finishNestedSwipe();
+			}
+
+			applySwipeProgress(resolvedProgress, true, swiping);
+		},
+		onRelease({
+			event,
+			deltaX,
+			deltaY,
+			direction,
+			velocityX,
+			velocityY,
+			releaseVelocityX,
+			releaseVelocityY,
+		}) {
+			const popupElement = store.context.popupRef.current;
+			if (!popupElement) {
+				clearSwipeRelease();
+				return undefined;
+			}
+			const releasePopupElement = popupElement;
+
+			function startSwipeRelease(resolvedDirection: SwipeDirection) {
+				// Start ending transition styles earlier and synchronously to prevent a period where
+				// the popup appears stuck on release before the actual closing animation starts.
+				finishNestedSwipe();
+				setSwipeDismissed(true);
+
+				releasePopupElement.style.removeProperty('transition');
+				releasePopupElement.setAttribute(TransitionStatusDataAttributes.endingStyle, '');
+				ReactDOM.flushSync(() => {
+					setSwipeRelease(
+						resolveSwipeRelease(
+							releasePopupElement,
+							resolvedDirection,
+							deltaX,
+							deltaY,
+							velocityX,
+							velocityY,
+							releaseVelocityX,
+							releaseVelocityY,
+						),
+					);
+				});
+			}
+
+			if (!snapPoints || snapPoints.length === 0) {
+				if (!direction) {
+					clearSwipeRelease();
+					return undefined;
+				}
+
+				const directionalDelta = getDisplacement(direction, deltaX, deltaY);
+				if (directionalDelta <= 0) {
+					clearSwipeRelease();
+					return false;
+				}
+
+				if (getDisplacement(direction, velocityX, velocityY) >= FAST_SWIPE_VELOCITY) {
+					startSwipeRelease(direction);
+					return true;
+				}
+
+				const shouldClose =
+					directionalDelta > getBaseSwipeThreshold(releasePopupElement, direction);
+				if (shouldClose) {
+					startSwipeRelease(direction);
+				} else {
+					clearSwipeRelease();
+				}
+				return shouldClose;
+			}
+
+			if (swipeDirection !== 'down' && swipeDirection !== 'up') {
+				clearSwipeRelease();
+				return undefined;
+			}
+
+			if (!popupHeight) {
+				clearSwipeRelease();
+				return false;
+			}
+
+			if (resolvedSnapPoints.length === 0) {
+				clearSwipeRelease();
+				return undefined;
+			}
+
+			const dragDelta = swipeDirection === 'down' ? deltaY : -deltaY;
+			const dragDirection = Math.sign(dragDelta);
+			const releaseDirectionalVelocity =
+				swipeDirection === 'down' ? releaseVelocityY : -releaseVelocityY;
+			const fallbackDirectionalVelocity = swipeDirection === 'down' ? velocityY : -velocityY;
+			let resolvedDirectionalVelocity = releaseDirectionalVelocity;
+			if (dragDirection !== 0 && Math.abs(dragDelta) >= MIN_SWIPE_THRESHOLD) {
+				const velocityDirection = Math.sign(resolvedDirectionalVelocity);
+				if (velocityDirection !== 0 && velocityDirection !== dragDirection) {
+					// Ignore touch reversals that would otherwise flip the snap decision.
+					resolvedDirectionalVelocity = fallbackDirectionalVelocity;
+				}
+			}
+
+			const currentOffset = activeSnapPointOffset ?? 0;
+			const dragTargetOffset = clamp(currentOffset + dragDelta, 0, popupHeight);
+			const velocityOffset =
+				Math.abs(resolvedDirectionalVelocity) >= SNAP_VELOCITY_THRESHOLD
+					? clamp(resolvedDirectionalVelocity, -MAX_SNAP_VELOCITY, MAX_SNAP_VELOCITY) *
+						SNAP_VELOCITY_MULTIPLIER
+					: 0;
+			const targetOffset = snapToSequentialPoints
+				? dragTargetOffset
+				: clamp(dragTargetOffset + velocityOffset, 0, popupHeight);
+			const snapPointEventDetails = createChangeEventDetails(REASONS.swipe, event);
+
+			const settleInPlace = () => {
+				// Reset nested swipe state now: the hook's trailing progress update is deduped
+				// when the drag never produced dismissal progress, so it may not fire.
+				applySwipeProgress(0, true, true);
+				clearSwipeRelease();
+				return false;
+			};
+
+			const settleOnSnapPoint = (snapPoint: ResolvedDrawerSnapPoint) => {
+				setActiveSnapPoint(snapPoint.value, snapPointEventDetails);
+				return settleInPlace();
+			};
+
+			const closeFromSnapPoints = (fallbackSnapPoint: ResolvedDrawerSnapPoint) => {
+				// An unattributed gesture (e.g. a mostly horizontal flick) may settle on a snap
+				// point but must not dismiss: `useSwipeDismiss` drops a directionless dismissal,
+				// stranding the popup visually closed while `open` stays `true`.
+				if (!direction) {
+					return settleOnSnapPoint(fallbackSnapPoint);
+				}
+				setActiveSnapPoint(null, snapPointEventDetails);
+				if (snapPointEventDetails.isCanceled) {
+					// A canceled null snap point rejects dismissal before exit styles start.
+					return settleInPlace();
+				}
+				pendingSwipeCloseSnapPointRef.current = activeSnapPoint;
+				startSwipeRelease(swipeDirection);
+				return true;
+			};
+
+			if (snapToSequentialPoints) {
+				const orderedSnapPoints = [...resolvedSnapPoints].sort(
+					(first, second) => first.offset - second.offset,
+				);
+				const orderedOffsets = orderedSnapPoints.map((point) => point.offset);
+				const currentIndex = closestSnapPointIndex(orderedOffsets, currentOffset);
+				let targetSnapPoint =
+					orderedSnapPoints[closestSnapPointIndex(orderedOffsets, targetOffset)];
+
+				const velocityDirection = Math.sign(resolvedDirectionalVelocity);
+				const shouldAdvance =
+					dragDirection !== 0 &&
+					velocityDirection !== 0 &&
+					velocityDirection === dragDirection &&
+					Math.abs(resolvedDirectionalVelocity) >= SNAP_VELOCITY_THRESHOLD;
+				let effectiveTargetOffset = targetOffset;
+
+				if (shouldAdvance) {
+					const adjacentIndex = clamp(
+						currentIndex + dragDirection,
+						0,
+						orderedSnapPoints.length - 1,
+					);
+					if (adjacentIndex !== currentIndex) {
+						const adjacentPoint = orderedSnapPoints[adjacentIndex];
+						const shouldForceAdjacent =
+							dragDirection > 0
+								? targetOffset < adjacentPoint.offset
+								: targetOffset > adjacentPoint.offset;
+						if (shouldForceAdjacent) {
+							targetSnapPoint = adjacentPoint;
+							effectiveTargetOffset = adjacentPoint.offset;
+						}
+					} else if (dragDirection > 0) {
+						return closeFromSnapPoints(targetSnapPoint);
+					}
+				}
+
+				const closeDistance = Math.abs(effectiveTargetOffset - popupHeight);
+				const snapDistance = Math.abs(effectiveTargetOffset - targetSnapPoint.offset);
+				if (closeDistance < snapDistance) {
+					return closeFromSnapPoints(targetSnapPoint);
+				}
+
+				return settleOnSnapPoint(targetSnapPoint);
+			}
+
+			const closestSnapPoint =
+				resolvedSnapPoints[
+					closestSnapPointIndex(
+						resolvedSnapPoints.map((point) => point.offset),
+						targetOffset,
+					)
+				];
+
+			if (resolvedDirectionalVelocity >= FAST_SWIPE_VELOCITY && dragDelta > 0) {
+				return closeFromSnapPoints(closestSnapPoint);
+			}
+
+			const closeDistance = Math.abs(targetOffset - popupHeight);
+			if (closeDistance < Math.abs(targetOffset - closestSnapPoint.offset)) {
+				return closeFromSnapPoints(closestSnapPoint);
+			}
+
+			return settleOnSnapPoint(closestSnapPoint);
+		},
+		onDismiss(event) {
+			visualStateStore?.set({ swipeProgress: 0, frontmostHeight: 0 });
+
+			const backdropElement = store.context.backdropRef.current;
+			if (backdropElement) {
+				backdropElement.style.setProperty(DrawerBackdropCssVars.swipeProgress, '0');
+				backdropElement.style.removeProperty(DrawerPopupCssVars.height);
+			}
+
+			const dismissEventDetails: Parameters<typeof store.setOpen>[1] = createChangeEventDetails(
+				REASONS.swipe,
+				event,
+			);
+			store.setOpen(false, dismissEventDetails);
+
+			if (dismissEventDetails.isCanceled) {
+				const pendingSnapPoint = pendingSwipeCloseSnapPointRef.current;
+				if (pendingSnapPoint !== undefined) {
+					setActiveSnapPoint(pendingSnapPoint, createChangeEventDetails(REASONS.swipe, event));
+				}
+
+				pendingSwipeCloseSnapPointRef.current = undefined;
+				resetSwipeRef.current?.();
+				clearSwipeRelease();
+				return;
+			}
+
+			// In controlled mode, the effective open state may not have changed yet
+			// (openProp takes precedence over state.open). Proceed optimistically with the
+			// dismiss animation — React's Scheduler flushes before the next rAF, so we can
+			// reliably check whether the parent accepted or rejected the close.
+			// Note: if onOpenChange is asynchronous (e.g., closes the drawer after a network
+			// call), the rAF check will see open === true, revert the animation, and the
+			// drawer will close without animation when the parent eventually sets open={false}.
+			if (store.select('open')) {
+				const savedEvent = event;
+				controlledDismissFrame.request(() => {
+					if (store.select('open')) {
+						// Parent rejected: revert animation and restore snap point.
+						const pendingSnapPoint = pendingSwipeCloseSnapPointRef.current;
+						if (pendingSnapPoint !== undefined) {
+							setActiveSnapPoint(
+								pendingSnapPoint,
+								createChangeEventDetails(REASONS.swipe, savedEvent),
+							);
+						}
+						pendingSwipeCloseSnapPointRef.current = undefined;
+						clearSwipeRelease();
+						resetSwipeRef.current?.();
+					} else {
+						// Parent accepted: clean up the ref.
+						pendingSwipeCloseSnapPointRef.current = undefined;
+					}
+				});
+				return;
+			}
+
+			pendingSwipeCloseSnapPointRef.current = undefined;
+			setSwipeDismissed(true);
+		},
+	});
+
+	const swipePointerProps = swipe.getPointerProps();
+	const swipeTouchProps = swipe.getTouchProps();
+	const { moveNative: moveSwipeNative, reset: resetSwipe } = swipe;
+
+	resetSwipeRef.current = resetSwipe;
+
+	React.useEffect(() => {
+		const rootElement = viewportElement ?? popupElementState;
+		if (!rootElement) {
+			return undefined;
+		}
+
+		const resolvedRootElement: HTMLElement = rootElement;
+
+		const doc = ownerDocument(resolvedRootElement);
+		function processTouchMove(event: TouchEvent, touchState: TouchScrollState, touch: Touch) {
+			const drawerAxisDelta = isVerticalScrollAxis
+				? touch.clientY - touchState.lastY
+				: touch.clientX - touchState.lastX;
+
+			// Avoid blocking pinch zoom or text selection adjustments on iOS Safari.
+			if (event.touches.length === 2) {
+				return;
+			}
+
+			const allowTouchMove = shouldIgnoreSwipeForTextSelection(doc, resolvedRootElement);
+
+			if (allowTouchMove || !open || !mounted || nestedDrawerOpen) {
+				return;
+			}
+
+			if (shouldYieldTouchMove(touchState, event, touch, isVerticalScrollAxis)) {
+				return;
+			}
+
+			const scrollTarget = touchState.scrollTarget;
+			if (!scrollTarget || scrollTarget === doc.documentElement || scrollTarget === doc.body) {
+				if (event.cancelable) {
+					event.preventDefault();
+				}
+				// Claim the gesture before React's delegated touch handlers see it; dispatching the
+				// move through React re-rasterizes the popup content on every frame.
+				event.stopPropagation();
+				moveSwipeNative(event, resolvedRootElement);
+				return;
+			}
+
+			if (!hasScrollableContentOnAxis(scrollTarget, scrollAxis)) {
+				// If the scroll container doesn't overflow on the drawer axis, prevent the window from
+				// scrolling instead.
+				if (event.cancelable) {
+					event.preventDefault();
+				}
+				event.stopPropagation();
+				return;
+			}
+
+			if (drawerAxisDelta !== 0) {
+				const canSwipeFromScrollEdge = canSwipeFromScrollEdgeOnMove(
+					scrollTarget,
+					scrollAxis,
+					swipeDirection,
+					drawerAxisDelta,
+				);
+
+				if (!touchState.allowSwipe) {
+					if (event.cancelable && canSwipeFromScrollEdge) {
+						touchState.allowSwipe = true;
+						event.preventDefault();
+					} else {
+						touchState.allowSwipe = false;
+					}
+				} else if (event.cancelable) {
+					event.preventDefault();
+				}
+			}
+
+			if (touchState.allowSwipe === true) {
+				event.stopPropagation();
+				moveSwipeNative(event, resolvedRootElement);
+			}
+		}
+
+		function handleNativeTouchMove(event: TouchEvent) {
+			// The virtual keyboard provider observes the move to tell a tap apart from a drag.
+			// It must run even when the swipe gesture below claims the event with
+			// `stopPropagation()`, which would otherwise prevent React's delegated handlers
+			// (and the provider) from ever seeing the move.
+			virtualKeyboard?.onTouchMove(event);
+
+			if (ignoreTouchSwipeRef.current) {
+				return;
+			}
+
+			const touchState = touchScrollStateRef.current;
+			const touch = event.touches[0];
+			if (!touch || !touchState) {
+				return;
+			}
+
+			processTouchMove(event, touchState, touch);
+			updateTouchScrollPosition(touchState, touch);
+		}
+
+		return addEventListener(doc, 'touchmove', handleNativeTouchMove, {
+			passive: false,
+			capture: true,
+		});
+	}, [
+		mounted,
+		nestedDrawerOpen,
+		open,
+		popupElementState,
+		isVerticalScrollAxis,
+		scrollAxis,
+		swipeDirection,
+		moveSwipeNative,
+		viewportElement,
+		virtualKeyboard,
+	]);
+
+	useIsoLayoutEffect(() => {
+		if (!snapPointRange || swipe.swiping) {
+			return;
+		}
+
+		applySwipeProgress(!open || nested ? 0 : (snapPointProgress ?? 0), true, false);
+	}, [
+		applySwipeProgress,
+		frontmostHeight,
+		nested,
+		notifyParentSwipeProgressChange,
+		open,
+		snapPointProgress,
+		snapPointRange,
+		swipe.swiping,
+		store,
+		visualStateStore,
+	]);
+
+	useIsoLayoutEffect(() => {
+		if (!notifyParentSwipeProgressChange) {
+			return undefined;
+		}
+
+		if (!open) {
+			notifyParentSwipeProgressChange(0);
+		}
+
+		return () => {
+			notifyParentSwipeProgressChange(0);
+		};
+	}, [notifyParentSwipeProgressChange, open]);
+
+	useIsoLayoutEffect(() => {
+		if (open) {
+			// Skip `resetSwipe` while `Drawer.SwipeArea` is driving the open: it zeroes the popup's
+			// `--swipe-movement-*` (via `syncDragStyles(false)`), flashing it fully open for a frame.
+			// `clearSwipeRelease` doesn't touch those vars, so always run it to clear any leftover
+			// release state from a prior dismiss (e.g. when the popup is kept mounted).
+			if (!swipeAreaActiveRef.current) {
+				resetSwipe();
+			}
+			clearSwipeRelease();
+		}
+	}, [clearSwipeRelease, open, resetSwipe, swipeAreaActiveRef]);
+
+	useIsoLayoutEffect(() => {
+		const backdropElement = backdropRef.current;
+
+		return () => {
+			visualStateStore?.set({ swipeProgress: 0, frontmostHeight: 0 });
+			setBackdropSwipingAttribute(backdropElement, false);
+			// `data-swiping` is set on whichever backdrop is current when a swipe starts, which can
+			// differ from the captured element if the backdrop mounted late or changed identity.
+			// Reading the live ref here is intentional so the current backdrop is cleared too.
+			// eslint-disable-next-line react-hooks/exhaustive-deps
+			const currentBackdrop = backdropRef.current;
+			if (currentBackdrop !== backdropElement) {
+				setBackdropSwipingAttribute(currentBackdrop, false);
+			}
+			finishNestedSwipe();
+		};
+	}, [backdropRef, finishNestedSwipe, visualStateStore]);
+
+	const swipeProviderValue = React.useMemo(
+		() => ({
+			swiping: swipe.swiping,
+			getDragStyles: swipe.getDragStyles,
+			swipeStrength: swipeRelease ?? null,
+			setSwipeDismissed,
+		}),
+		[setSwipeDismissed, swipe.getDragStyles, swipe.swiping, swipeRelease],
+	);
+
+	function resetTouchSwipeState(ignoreSwipe: boolean) {
+		ignoreTouchSwipeRef.current = ignoreSwipe;
+		touchScrollStateRef.current = null;
+	}
+
+	function resetTouchTrackingState() {
+		resetTouchSwipeState(false);
+		lastPointerTypeRef.current = '';
+		ignoreNextTouchStartFromPenRef.current = false;
+	}
+
+	function handlePointerEnd(event: React.PointerEvent): boolean {
+		lastPointerTypeRef.current = '';
+		return event.pointerType !== 'touch';
+	}
+
+	return (
+		<DialogViewport
+			ref={forwardedRef}
+			render={render}
+			{...mergeProps<'div'>(elementProps, {
+				onPointerDown(event) {
+					lastPointerTypeRef.current = event.pointerType;
+					ignoreNextTouchStartFromPenRef.current = event.pointerType === 'pen';
+
+					if (!open || !mounted || nestedDrawerOpen) {
+						return;
+					}
+
+					const elementAtPoint = getElementAtPoint(
+						event.currentTarget.getRootNode(),
+						event.clientX,
+						event.clientY,
+					);
+					if (isSwipeIgnoredTarget(elementAtPoint) || isDrawerContentTarget(elementAtPoint)) {
+						return;
+					}
+
+					if (event.pointerType === 'touch') {
+						return;
+					}
+
+					swipePointerProps.onPointerDown?.(event);
+				},
+				onPointerMove(event) {
+					if (event.pointerType === 'touch') {
+						return;
+					}
+
+					swipePointerProps.onPointerMove?.(event);
+				},
+				onPointerUp(event) {
+					if (handlePointerEnd(event)) {
+						swipePointerProps.onPointerUp?.(event);
+					}
+				},
+				onPointerCancel(event) {
+					if (handlePointerEnd(event)) {
+						swipePointerProps.onPointerCancel?.(event);
+					}
+				},
+				onTouchStart(event) {
+					const startedFromPenPointerDown =
+						lastPointerTypeRef.current === 'pen' && ignoreNextTouchStartFromPenRef.current;
+					if (startedFromPenPointerDown) {
+						ignoreNextTouchStartFromPenRef.current = false;
+						resetTouchSwipeState(false);
+						return;
+					}
+
+					if (!open || !mounted || nestedDrawerOpen) {
+						resetTouchSwipeState(false);
+						return;
+					}
+
+					const touch = event.touches[0];
+					if (!touch) {
+						return;
+					}
+
+					if (isReactTouchEventOnRangeInput(event)) {
+						resetTouchSwipeState(false);
+						return;
+					}
+
+					const rootElement = event.currentTarget;
+					const elementAtPoint = getElementAtPoint(
+						rootElement.getRootNode(),
+						touch.clientX,
+						touch.clientY,
+					);
+					const eventTarget = getTarget(event);
+					const target = isElement(eventTarget) ? eventTarget : rootElement;
+					if (!contains(rootElement, target)) {
+						resetTouchSwipeState(true);
+						return;
+					}
+
+					virtualKeyboard?.onTouchStart(event);
+
+					if (isSwipeIgnoredTarget(elementAtPoint)) {
+						resetTouchSwipeState(true);
+						return;
+					}
+					ignoreTouchSwipeRef.current = false;
+
+					const scrollTarget = findScrollableTouchTarget(target, rootElement, scrollAxis);
+					const hasCrossAxisScrollableContent =
+						findScrollableTouchTarget(target, rootElement, crossScrollAxis) != null;
+
+					let allowSwipe: boolean | null = null;
+					if (scrollTarget) {
+						const canSwipeFromEdge = isAtSwipeStartEdge(scrollTarget, scrollAxis, swipeDirection);
+
+						allowSwipe = canSwipeFromEdge ? null : false;
+					}
+
+					touchScrollStateRef.current = {
+						startX: touch.clientX,
+						startY: touch.clientY,
+						lastX: touch.clientX,
+						lastY: touch.clientY,
+						scrollTarget,
+						hasCrossAxisScrollableContent,
+						allowSwipe,
+						preserveNativeCrossAxisScroll: false,
+						drawerAxisAttributed: false,
+					};
+
+					swipeTouchProps.onTouchStart?.(event);
+				},
+				onTouchEnd(event) {
+					virtualKeyboard?.onTouchEnd(event);
+					resetTouchTrackingState();
+					swipeTouchProps.onTouchEnd?.(event);
+				},
+				onTouchCancel(event) {
+					virtualKeyboard?.onTouchCancel();
+					resetTouchTrackingState();
+					swipeTouchProps.onTouchCancel?.(event);
+				},
+				// Drawer popups use drawer-specific nested state attributes.
+				// Suppress DialogViewport's generic nested dialog attribute.
+				[DialogViewportDataAttributes.nestedDialogOpen as string]: undefined,
+			})}
+			className={className}
+			style={style}
+		>
+			<DrawerViewportContext.Provider value={swipeProviderValue}>
+				{children}
+			</DrawerViewportContext.Provider>
+		</DialogViewport>
+	);
+};
+
+export interface DrawerViewportState {
+	/**
+	 * Whether the drawer is currently open.
+	 */
+	open: boolean;
+	/**
+	 * The transition status of the component.
+	 */
+	transitionStatus: TransitionStatus;
+	/**
+	 * Whether the drawer is nested within another drawer.
+	 */
+	nested: boolean;
+	/**
+	 * Whether the drawer has nested drawers open.
+	 */
+	nestedDialogOpen: boolean;
+}
+
+export interface DrawerViewportProps extends BaseUIComponentProps<'div', DrawerViewportState> {}
+
+export namespace DrawerViewport {
+	export type Props = DrawerViewportProps;
+	export type State = DrawerViewportState;
+}
+
+function setBackdropSwipingAttribute(backdropElement: HTMLElement | null, swiping: boolean) {
+	backdropElement?.toggleAttribute(DrawerPopupDataAttributes.swiping, swiping);
+}
+
+function isSwipeIgnoredTarget(target: Element | null): boolean {
+	return Boolean(target?.closest(BASE_UI_SWIPE_IGNORE_SELECTOR));
+}
+
+function isDrawerContentTarget(target: Element | null): boolean {
+	return Boolean(target?.closest(DRAWER_CONTENT_SELECTOR));
+}
+
+function getBaseSwipeSize(element: HTMLElement, direction: SwipeDirection): number {
+	return direction === 'left' || direction === 'right' ? element.offsetWidth : element.offsetHeight;
+}
+
+function getBaseSwipeThreshold(element: HTMLElement, direction: SwipeDirection): number {
+	return Math.max(getBaseSwipeSize(element, direction) * 0.5, MIN_SWIPE_THRESHOLD);
+}
+
+function isRangeInput(
+	target: EventTarget | null,
+	win: ReturnType<typeof ownerWindow>,
+): target is HTMLInputElement {
+	return target instanceof win.HTMLInputElement && target.type === 'range';
+}
+
+function isTextSelectionControl(target: Element): target is HTMLInputElement | HTMLTextAreaElement {
+	return target.tagName === 'INPUT' || target.tagName === 'TEXTAREA';
+}
+
+function hasExpandedSelectionWithinTarget(selection: Selection, target: Element): boolean {
+	const anchorElement = isElement(selection.anchorNode)
+		? selection.anchorNode
+		: selection.anchorNode?.parentElement;
+	const focusElement = isElement(selection.focusNode)
+		? selection.focusNode
+		: selection.focusNode?.parentElement;
+
+	return (
+		selection.containsNode(target, true) ||
+		contains(target, anchorElement) ||
+		contains(target, focusElement)
+	);
+}
+
+function shouldIgnoreSwipeForTextSelection(doc: Document, rootElement: HTMLElement): boolean {
+	const activeEl = activeElement(doc);
+	if (activeEl && contains(rootElement, activeEl) && isTextSelectionControl(activeEl)) {
+		const { selectionStart, selectionEnd } = activeEl;
+		if (selectionStart != null && selectionEnd != null && selectionStart < selectionEnd) {
+			return true;
+		}
+	}
+
+	const selection = doc.getSelection?.();
+	if (!selection || selection.isCollapsed) {
+		return false;
+	}
+
+	return hasExpandedSelectionWithinTarget(selection, rootElement);
+}
+
+function isEventOnRangeInput(event: TouchEvent, win: ReturnType<typeof ownerWindow>): boolean {
+	return event.composedPath().some((pathTarget) => isRangeInput(pathTarget, win));
+}
+
+function isReactTouchEventOnRangeInput(event: React.TouchEvent<Element>): boolean {
+	return isEventOnRangeInput(event, ownerWindow(event.currentTarget));
+}
+
+function updateTouchScrollPosition(touchState: TouchScrollState, touch: Touch): void {
+	touchState.lastX = touch.clientX;
+	touchState.lastY = touch.clientY;
+}
+
+/**
+ * Arbitrates a touchmove between the drawer swipe and a native cross-axis scroll.
+ * Returns `true` when the move must be left alone — either because the cross axis already won the
+ * gesture, or because neither axis has passed the slop yet and the gesture cannot be attributed.
+ */
+function shouldYieldTouchMove(
+	touchState: TouchScrollState,
+	event: TouchEvent,
+	touch: Touch,
+	isVerticalScrollAxis: boolean,
+): boolean {
+	if (touchState.preserveNativeCrossAxisScroll) {
+		return true;
+	}
+
+	// Attribution happens once per gesture. Re-arbitrating after the drawer axis has won would let
+	// the pre-attribution branches below fire mid-drag (the slop is measured from the touch origin,
+	// which is never re-baselined), freezing the popup and dropping `preventDefault()`.
+	if (
+		touchState.drawerAxisAttributed ||
+		touchState.allowSwipe === true ||
+		!touchState.hasCrossAxisScrollableContent
+	) {
+		return false;
+	}
+
+	// A non-cancelable touchmove means the browser has already committed the gesture to a native
+	// scroll; claiming it for the swipe would drag the popup alongside the scrolling content.
+	if (!event.cancelable) {
+		touchState.preserveNativeCrossAxisScroll = true;
+		return true;
+	}
+
+	const drawerAxisGestureDelta = isVerticalScrollAxis
+		? touch.clientY - touchState.startY
+		: touch.clientX - touchState.startX;
+	const crossAxisGestureDelta = isVerticalScrollAxis
+		? touch.clientX - touchState.startX
+		: touch.clientY - touchState.startY;
+	const absDrawerAxisGestureDelta = Math.abs(drawerAxisGestureDelta);
+	const absCrossAxisGestureDelta = Math.abs(crossAxisGestureDelta);
+
+	if (
+		absCrossAxisGestureDelta >= AXIS_LOCK_SLOP &&
+		absCrossAxisGestureDelta > absDrawerAxisGestureDelta + AXIS_LOCK_BIAS
+	) {
+		touchState.preserveNativeCrossAxisScroll = true;
+		return true;
+	}
+
+	if (absDrawerAxisGestureDelta >= AXIS_LOCK_SLOP) {
+		touchState.drawerAxisAttributed = true;
+		return false;
+	}
+
+	// Neither axis has traveled past the slop yet, so the gesture cannot be attributed. Leave the
+	// event alone: on iOS, `preventDefault()` on the first cancelable touchmove cancels native
+	// scrolling for the entire gesture, which would lock a cross-axis scroll that only passes the
+	// slop on a later move.
+	return true;
+}
+
+function hasScrollableContentOnAxis(scrollTarget: HTMLElement, axis: ScrollAxis): boolean {
+	return getScrollMetrics(scrollTarget, axis).max > 0;
+}
+
+function getScrollMetrics(scrollTarget: HTMLElement, axis: ScrollAxis) {
+	if (axis === 'vertical') {
+		const max = Math.max(0, scrollTarget.scrollHeight - scrollTarget.clientHeight);
+		return { offset: scrollTarget.scrollTop, max };
+	}
+
+	const max = Math.max(0, scrollTarget.scrollWidth - scrollTarget.clientWidth);
+	return { offset: scrollTarget.scrollLeft, max };
+}
+
+function isAtSwipeStartEdge(
+	scrollTarget: HTMLElement,
+	axis: ScrollAxis,
+	direction: SwipeDirection,
+): boolean {
+	const dismissFromStartEdge = shouldDismissFromStartEdge(direction, axis);
+	const { offset, max } = getScrollMetrics(scrollTarget, axis);
+	return dismissFromStartEdge ? offset <= 0 : offset >= max;
+}
+
+function canSwipeFromScrollEdgeOnMove(
+	scrollTarget: HTMLElement,
+	axis: ScrollAxis,
+	direction: SwipeDirection,
+	delta: number,
+): boolean {
+	const dismissFromStartEdge = shouldDismissFromStartEdge(direction, axis);
+	const movingTowardDismiss = dismissFromStartEdge ? delta > 0 : delta < 0;
+	if (!movingTowardDismiss) {
+		return false;
+	}
+
+	return isAtSwipeStartEdge(scrollTarget, axis, direction);
+}
+
+function shouldDismissFromStartEdge(direction: SwipeDirection, axis: ScrollAxis): boolean {
+	return axis === 'vertical' ? direction === 'down' : direction === 'right';
+}