@botiverse/raft-ui 0.96.0 → 0.96.1

package/CHANGELOG.md

@@ -1,3 +1,12 @@
+## [0.96.1](https://github.com/botiverse/raft-design/compare/v0.96.0...v0.96.1) (2026-11-13)
+
+### Fixed
+
+- **A popup anchored in a sheet's body is always kept under the sheet's head, however little room its field has** ([Dialog › Popups in a sheet](https://raft-design.botiverse.build/components/dialog/#popups-in-a-sheet), [Drawer › Behavior](https://raft-design.botiverse.build/components/drawer/#behavior)). In `DialogSheetContent` below 768px, in a `Drawer` and under `SheetPopupBoundary`, the sheet no longer stops bounding a list whose field has little of the sheet's area on both sides: the list flips to the larger side, shrinks to it and scrolls. The `POPUP_ROOM_MIN_PX` constant in `lib/popup-boundary`, which no entry point exported, is removed.
+  - Why: the exception let the list open over the head in the commonest real case, a field in the middle of a sheet on a small phone with the keyboard up (about 130px on each side). There the list covered the head, or, when an app portaled it into the sheet's scrolling body, was drawn under the head, where its first rows could be neither seen nor pressed. A short list that scrolls can be used; one hidden under the head can't.
+  - Affects: a Select or Combobox list, a menu or a popover opened from a field with little room on both sides, which used to open over the head at its full height, now stays under the head at the height of the larger side less 12px: 128px with 140px of room, 88px with 100px, 48px with 60px. No popup sets a least height, so in a very short sheet a list can show one row or less. A popup anchored in the head, a sheet with no head, a centered dialog and a popup with its own `collisionBoundary` are unchanged (`"clipping-ancestors"` still opts one out).
+  - Docs: https://raft-design.botiverse.build/components/dialog/#popups-in-a-sheet
+
 ## [0.96.0](https://github.com/botiverse/raft-design/compare/v0.95.4...v0.96.0) (2026-11-13)
 
 ### Changed

package/dist/lib/popup-boundary.mjs

@@ -123,10 +123,15 @@ function nextFrame(clear) {
 *
 * - the popup's anchor is inside the head (a tooltip or a menu on a head
 *   button belongs above or over the head, not under it);
-* - neither side of the anchor has `POPUP_ROOM_MIN_PX` of the area: a list
-*   held there would show a row or two, so it opens over the head instead;
 * - the sheet has no head, or nothing visible under it.
 *
+* While the anchor is in the sheet's body the area always bounds the popup,
+* however little of it either side of the anchor has: the list takes the
+* larger side and scrolls. On a small phone with the keyboard up a field in
+* the middle of a sheet has about 130px each side; a short list there can be
+* used, and one let over the head covers it, or, portaled into the sheet's
+* scrolling body, is drawn under it, where its first rows can't be pressed.
+*
 * The anchor is the popup's own `anchor` prop when `anchor` returns one that
 * resolves to something (resolvePopupAnchor), and the trigger found in the
 * page otherwise (findPopupAnchor). A virtual anchor has no element, so it is
@@ -175,17 +180,14 @@ function sheetPopupBoundary(sheet, popup = () => null, anchor = () => void 0) {
 		const positioner = popup();
 		const target = resolvePopupAnchor(anchor()) ?? lookUp(positioner);
 		if (target) {
-			const anchorBox = target.getBoundingClientRect();
 			if (isElement(target)) {
 				if (head.contains(target)) return null;
 			} else {
+				const anchorBox = target.getBoundingClientRect();
 				const x = (anchorBox.left + anchorBox.right) / 2;
 				const y = (anchorBox.top + anchorBox.bottom) / 2;
 				if (x >= headBox.left && x <= headBox.right && y >= headBox.top && y <= headBox.bottom) return null;
 			}
-			const above = Math.min(anchorBox.top, bottom) - top;
-			const below = bottom - Math.max(anchorBox.bottom, top);
-			if (Math.max(above, below) < 150) return null;
 		}
 		return {
 			top: top + visualViewportShift(positioner).y,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@botiverse/raft-ui",
-  "version": "0.96.0",
+  "version": "0.96.1",
   "description": "React components and CSS foundations for the Raft Design System.",
   "keywords": [
     "agent-skills",