feat(mobile): iPhone Duo support (fold-aware dialogs, no phantom keyboard)

Apple's "Designing for iPhone Duo" asks an app to adapt to both displays,
to stay continuous as the device opens and closes, and to treat the band a
partly-open display folds through as a reserved region. Three things here.

1. A visual-viewport resize that changes the WIDTH is the device changing
   shape (a rotation, or a foldable opening or closing) and is never the
   virtual keyboard, which only ever takes height. handleViewportResize()
   read any height drop over 150px as the keyboard appearing, so closing a
   Duo (890 to 678pt tall) latched keyboardVisible with no keyboard on
   screen: the accessory bar appeared, main grew 84px of dead padding, and
   updateAppHeight() stopped refreshing --app-height. The latch was sticky,
   because clearing it needs the height back within 100px of a baseline
   belonging to a display the user is no longer looking at. Rotating any
   phone hit the same latch. The shape branch re-baselines instead, which
   is also what lets a keyboard opened after the fold be detected.

2. The hinge is now a reserved region in CSS. --fold-inline-end and
   --fold-block-end measure the strip to keep clear from the Viewport
   Segments env() variables, and are 0px everywhere else, so the seven
   centred overlays are inert by construction off a foldable. Each shrinks
   its content box with padding rather than the box itself, so the backdrop
   still covers the far side of the fold and still swallows taps there.

3. iPhone Duo (outer) and iPhone Duo (inner) join the mobile device
   registry, derived from Apple's published pixel specs at 3x.

Verified in Chromium: flat, a dialog stays centred at 313 of a 626pt
viewport; in book pose it centres at 153 inside the 0-305 leading segment
with its right edge at 293, while the backdrop still spans all 626. The
3-term calc on the offline overlay resolves to 367px in tabletop pose and
20px flat.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
This commit is contained in:
Codeman maintainer
2026-09-14 15:57:08 +02:00
parent a5cf1f6005
commit 8389423459
7 changed files with 658 additions and 7 deletions
+103
View File
@@ -18066,3 +18066,106 @@ html[data-session-list="sidebar"][data-sidebar="collapsed"] .btn-sidebar-toggle
transition: none;
}
}
/* ============================================================
=== Folding devices: keep dialogs off the hinge ===
Apple's "Designing for iPhone Duo" calls the band a partly-open
display folds through a RESERVED REGION: content avoids covering
it, and system components (alerts, sheets, context menus) move
aside for it. On the web that region is described by the CSS
Viewport Segments media features and env() variables, which report
two segments only while a foldable is actually bent. Flat, open
or closed, it is one segment and everything below is inert.
Codeman's centred overlays are all `position: fixed; inset: 0`
flex-centring boxes, so their dialog lands dead on the hinge in
book pose (a vertical fold) or tabletop pose (a horizontal one).
The fix shrinks the CONTENT box with padding rather than the box
itself, so each overlay's backdrop still covers the whole viewport
and still swallows taps on the far side of the fold. Shrinking
the box would leave the trailing segment unshaded and live.
⚠️ Each rule re-states the overlay's OWN gutter, because a
later `padding-right` longhand beats the earlier `padding`
shorthand it is composing with and would otherwise erase it.
test/iphone-duo-fold.test.ts reads both numbers out of this file
and fails if they drift apart.
⚠️ Physical sides, not logical ones: dialogs go in the LEFT
segment (and the TOP one in tabletop pose) in every language. The
HIG keeps Duo's side controls on the same physical edge in RTL
because they are aligned with the hardware, and a dialog that
changed sides with the text direction would fight that.
============================================================ */
:root {
/* Width of the trailing strip to leave clear so a centred dialog cannot sit
under a vertical hinge, and the matching bottom strip for a horizontal one.
0px on every non-folding device, and on a foldable held flat. */
--fold-inline-end: 0px;
--fold-block-end: 0px;
}
@media (horizontal-viewport-segments: 2) {
:root {
--fold-inline-end: calc(100vw - env(viewport-segment-right 0 0, 100vw));
}
}
@media (vertical-viewport-segments: 2) {
:root {
--fold-block-end: calc(100vh - env(viewport-segment-bottom 0 0, 100vh));
}
}
/* No gutter of their own. */
.modal,
.file-preview-overlay {
padding-right: var(--fold-inline-end);
padding-bottom: var(--fold-block-end);
}
/* Specificity 0,2,0 on purpose: mobile.css loads after this file and gives the
palette a `padding` SHORTHAND under 768px, exactly the width where a folding
phone lives, so a bare .command-palette-modal rule here would lose to it. The
0.75rem side gutter is that mobile rule's; the desktop rule sets no side
padding, so composing with it is a no-op above 768px. */
.modal.command-palette-modal {
padding-right: calc(0.75rem + var(--fold-inline-end));
}
.path-picker-overlay {
padding-right: calc(16px + var(--fold-inline-end));
padding-bottom: calc(16px + var(--fold-block-end));
}
.path-preview-overlay {
padding-right: calc(18px + var(--fold-inline-end));
padding-bottom: calc(18px + var(--fold-block-end));
}
.offline-overlay {
padding-right: calc(20px + var(--fold-inline-end));
padding-bottom: calc(20px + var(--safe-area-bottom) + var(--fold-block-end));
}
.solo-gone-overlay {
padding-right: calc(24px + var(--fold-inline-end));
padding-bottom: calc(24px + var(--fold-block-end));
}
/* Top-anchored, so only the trailing side and the bottom stop matter. */
.paste-overlay {
padding-right: var(--fold-inline-end);
padding-bottom: var(--fold-block-end);
}
/* The response viewer is a bottom sheet, so a vertical hinge running through it
is fine, since it is a wide surface like the terminal and inset dialogs are what
the fold guidance is about. A horizontal hinge is not: in tabletop pose the
sheet would climb out of the bottom segment and fold away mid-transcript. */
@media (vertical-viewport-segments: 2) {
.response-viewer {
max-height: min(88vh, env(viewport-segment-height 0 1, 88vh));
}
}