@sovereignfs/ui 0.21.3 → 0.33.0

package/dist/Dialog.module.css

@@ -31,6 +31,16 @@
   padding: var(--sv-space-8);
   padding-left: calc(var(--sv-dialog-inset-left, 0px) + var(--sv-space-8));
   background: var(--sv-color-scrim);
+  /* Entrance/exit fade. The Dialog component drives this via a two-phase
+     mount (see motion.ts) — .scrimOpen is added one frame after mount so this
+     transition has somewhere to animate from, and removed (while staying
+     mounted) for the exit before the component actually unmounts. */
+  opacity: 0;
+  transition: opacity var(--sv-motion-duration-base) var(--sv-motion-ease-out);
+}
+
+.scrimOpen {
+  opacity: 1;
 }
 
 .panel {
@@ -43,6 +53,30 @@
   border: 1px solid var(--sv-color-border);
   border-radius: var(--sv-radius-lg);
   box-shadow: var(--sv-shadow-overlay);
+  /* Desktop entrance: fade + gentle scale-up. Same two-phase-mount pattern as
+     .scrim above. Mobile overrides this to a slide-up instead (below). */
+  opacity: 0;
+  transform: scale(0.96);
+  transition:
+    opacity var(--sv-motion-duration-base) var(--sv-motion-ease-out),
+    transform var(--sv-motion-duration-base) var(--sv-motion-ease-out);
+}
+
+.panelOpen {
+  opacity: 1;
+  transform: scale(1);
+}
+
+/* prefers-reduced-motion: collapse both fade/scale and slide to near-instant.
+   Not literally 0 — a 0ms transition can skip applying entirely in some
+   engines, and the JS unmount timer (Dialog.tsx's MOTION_DURATION_MS,
+   switched to ~0 via usePrefersReducedMotion) needs a transition to still be
+   "present" for the visual state to actually reach its end value in time. */
+@media (prefers-reduced-motion: reduce) {
+  .scrim,
+  .panel {
+    transition-duration: 0.01ms;
+  }
 }
 
 .content {
@@ -53,7 +87,7 @@
   /* Disable elastic overscroll within the dialog: `none` stops both scroll-
      chaining to the parent and the iOS rubber-band bounce inside the panel.
      `contain` only prevents chaining — the panel itself still bounces, which
-     reveals white panel-background between the mobileBar and the sticky tab
+     reveals white panel-background between OverlayHeader and the sticky tab
      strip on iOS PWA. A dialog is a bounded surface where bounce is a visual
      bug, not a feature. */
   overscroll-behavior: none;
@@ -100,9 +134,11 @@
   cursor: pointer;
 }
 
-.close:hover {
-  background: var(--sv-color-surface-sunken);
-  color: var(--sv-color-text-primary);
+@media (hover: hover) {
+  .close:hover {
+    background: var(--sv-color-surface-sunken);
+    color: var(--sv-color-text-primary);
+  }
 }
 
 .close:focus-visible {
@@ -110,8 +146,10 @@
   outline-offset: 2px;
 }
 
-/* Hidden on desktop; shown only on mobile where it replaces the close button. */
-.mobileBar {
+/* Hidden on desktop; shown only on mobile where it replaces the close button.
+ * OverlayHeader owns its own background/border/padding — this wrapper class
+ * only toggles visibility per breakpoint. */
+.mobileHeader {
   display: none;
 }
 
@@ -122,10 +160,14 @@
 @media (max-width: 768px) {
   /* On mobile the overlay feels like a full-page push, not a floating modal.
      Remove the dim scrim and panel chrome so it's indistinguishable from a
-     regular page render. router.back() still closes it correctly. */
+     regular page render. router.back() still closes it correctly.
+     bottom stops the scrim above the footer nav (matching Drawer) instead of
+     running the full viewport height — the panel used to extend under the
+     footer with only .content's own padding compensating for it. */
   .scrim {
     padding: 0;
     background: transparent;
+    bottom: var(--sv-shell-footer-height, 0);
   }
 
   .panel,
@@ -143,54 +185,39 @@
     background: var(--sv-color-surface);
   }
 
-  /* Desktop close button is replaced by mobileBar on mobile. */
-  .close {
-    display: none;
-  }
-
-  /* Title + close button in one solid row. Being a flex sibling before
-     .content means it never scrolls — the content area scrolls below it. */
-  .mobileBar {
-    display: flex;
-    align-items: center;
-    flex-shrink: 0;
-    padding: var(--sv-space-3) var(--sv-space-4);
-    background: var(--sv-color-surface);
-    border-bottom: 1px solid var(--sv-color-border);
+  /* Mobile entrance is a slide-up, not the desktop fade+scale — matches "page
+     push" framing above. No opacity change (the panel is opaque full-screen
+     content, not a floating box), so only transform needs a transition here. */
+  .panel {
+    opacity: 1;
+    transform: translateY(100%);
+    transition: transform var(--sv-motion-duration-base) var(--sv-motion-ease-out);
   }
 
-  .mobileBarTitle {
-    flex: 1;
-    font-size: var(--sv-font-size-xl);
-    font-weight: var(--sv-font-weight-semibold);
-    color: var(--sv-color-text-primary);
+  .panelOpen {
+    transform: translateY(0);
   }
 
-  .mobileBarClose {
-    display: inline-flex;
-    align-items: center;
-    justify-content: center;
-    width: var(--sv-space-8);
-    height: var(--sv-space-8);
-    flex-shrink: 0;
-    border: none;
-    border-radius: var(--sv-radius-md);
-    background: transparent;
-    color: var(--sv-color-text-muted);
-    font-size: var(--sv-font-size-xl);
-    line-height: 1;
-    cursor: pointer;
+  /* Desktop close button is replaced by OverlayHeader on mobile. */
+  .close {
+    display: none;
   }
 
-  .mobileBarClose:hover {
-    background: var(--sv-color-surface-sunken);
-    color: var(--sv-color-text-primary);
+  /* Title + close button in one solid row, via the shared OverlayHeader
+     component. Being a flex sibling before .content means it never scrolls —
+     the content area scrolls below it. */
+  .mobileHeader {
+    display: block;
   }
 
-  /* Remove top padding so the sticky plugin header sits flush against the
-     mobileBar — no gap for scrolling content to bleed through. */
+  /* Remove top padding so the sticky plugin header sits flush against
+     OverlayHeader — no gap for scrolling content to bleed through.
+     padding-bottom no longer adds --sv-shell-footer-height on top of
+     --sv-space-6 — the scrim above already stops short of the footer, so
+     .content doesn't need to additionally compensate for it here (that used
+     to double-count the footer clearance). */
   .content {
     padding-top: 0;
-    padding-bottom: calc(var(--sv-shell-footer-height, 60px) + var(--sv-space-6, 24px));
+    padding-bottom: var(--sv-space-6, 24px);
   }
 }

package/dist/DragHandleRow.module.css

@@ -0,0 +1,57 @@
+.row {
+  display: flex;
+  align-items: flex-start;
+  gap: var(--sv-space-1);
+  position: relative;
+}
+
+/* Hover-reveal only where hover genuinely exists — on touch the handle would
+   otherwise never become visible (tap-generated hover doesn't count as a
+   sustained hover state, and :not(:hover) is always true with no hover
+   capability at all), so it stays visible by default there. */
+@media (hover: hover) {
+  .row:not(:hover) .handle,
+  .row:not(:focus-within) .handle {
+    opacity: 0;
+  }
+}
+
+.handle {
+  flex-shrink: 0;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  width: 24px;
+  height: 24px;
+  margin-top: 2px;
+  border: none;
+  background: none;
+  padding: 0;
+  border-radius: var(--sv-radius-sm);
+  color: var(--sv-color-text-muted);
+  cursor: grab;
+  opacity: 1;
+  transition: opacity 0.1s ease;
+}
+
+.handle:focus-visible {
+  outline: 2px solid var(--sv-color-focus-ring);
+  outline-offset: 2px;
+}
+
+.handle:active {
+  cursor: grabbing;
+}
+
+.icon {
+  pointer-events: none;
+}
+
+.content {
+  flex: 1;
+  min-width: 0;
+}
+
+.dragging {
+  opacity: 0.5;
+}

package/dist/Drawer.module.css

@@ -14,6 +14,14 @@
   display: flex;
   align-items: flex-end;
   background: var(--sv-color-scrim);
+  /* Entrance/exit fade — same two-phase-mount pattern as Dialog (see motion.ts
+     and Drawer.tsx). */
+  opacity: 0;
+  transition: opacity var(--sv-motion-duration-base) var(--sv-motion-ease-out);
+}
+
+.scrimOpen {
+  opacity: 1;
 }
 
 .panel {
@@ -28,4 +36,57 @@
   /* Pull content above the home indicator / bottom bar in standalone mode. */
   padding-bottom: env(safe-area-inset-bottom);
   outline: none;
+  /* Slide up from below the viewport. Always a bottom sheet, so unlike Dialog
+     there's no desktop-vs-mobile fork here. */
+  transform: translateY(100%);
+  transition: transform var(--sv-motion-duration-base) var(--sv-motion-ease-out);
+}
+
+.panelOpen {
+  transform: translateY(0);
+}
+
+/* 'half' snapHeight — a fixed height instead of the default content-sized cap
+ * above. Per the design-system's "half screen or less" convention for
+ * Drawer; content taller than this belongs in Sheet instead. */
+.panelHalf {
+  height: 50dvh;
+  max-height: 50dvh;
+}
+
+/* See Dialog.module.css's identical rule for why 0.01ms rather than 0. */
+@media (prefers-reduced-motion: reduce) {
+  .scrim,
+  .panel {
+    transition-duration: 0.01ms;
+  }
+}
+
+/* Grab handle — the sole drag-initiation region for swipe-down-to-dismiss
+ * (see Drawer.tsx's doc comment for why not the whole panel). The visual bar
+ * (::before) stays the small, established 36x4px size; only the hit area
+ * grows to a comfortable touch target. */
+.handle {
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  width: 100%;
+  height: var(--sv-touch-target-min, 44px);
+  flex-shrink: 0;
+  cursor: grab;
+  /* JS-driven drag — the browser must not treat a press here as a
+     scroll/pan gesture that would fight it. */
+  touch-action: none;
+}
+
+.handle:active {
+  cursor: grabbing;
+}
+
+.handle::before {
+  content: '';
+  width: 36px;
+  height: 4px;
+  border-radius: var(--sv-radius-full);
+  background: var(--sv-color-border-strong);
 }

package/dist/FormField.module.css

@@ -2,6 +2,11 @@
   display: flex;
   flex-direction: column;
   gap: var(--sv-space-1);
+  /* Every local .field/.fieldGroup class this component replaced set this
+     explicitly. Without it, a parent with align-items: flex-start (needed so
+     submit buttons don't stretch full-width) shrink-wraps this wrapper to its
+     content's intrinsic width instead of filling the available space. */
+  width: 100%;
 }
 
 .label {

package/dist/Icon.module.css

@@ -6,6 +6,11 @@
   /* Color follows the surrounding text via currentColor — no token needed. */
 }
 
+.xs {
+  width: var(--sv-icon-size-xs);
+  height: var(--sv-icon-size-xs);
+}
+
 .sm {
   width: var(--sv-icon-size-sm);
   height: var(--sv-icon-size-sm);

package/dist/Input.module.css

@@ -14,6 +14,16 @@
     box-shadow 0.15s ease;
 }
 
+/* iOS Safari (tab and standalone PWA) auto-zooms the page whenever a focused
+   input's font-size is below 16px. The viewport intentionally allows pinch-zoom
+   (no maximum-scale — an accessibility requirement), so the only way to stop the
+   focus-zoom is to render the field at >=16px on touch devices. */
+@media (pointer: coarse) {
+  .input {
+    font-size: var(--sv-font-size-md);
+  }
+}
+
 .input::placeholder {
   color: var(--sv-color-text-muted);
 }

package/dist/Menu.module.css

@@ -0,0 +1,82 @@
+/* Menu — the item list shared by both presentations (Popover panel on
+ * desktop, Drawer panel on mobile); the presentational chrome around it is
+ * entirely owned by those two components, not duplicated here. */
+
+.list {
+  list-style: none;
+  margin: 0;
+  padding: var(--sv-space-1);
+  display: flex;
+  flex-direction: column;
+}
+
+.item {
+  display: flex;
+  align-items: center;
+  gap: var(--sv-space-2);
+  width: 100%;
+  /* Min touch target (WCAG 2.5.5 / Apple HIG) — this menu renders as a
+     Drawer sheet on mobile, so every item must be comfortably tappable. */
+  min-height: var(--sv-touch-target-min, 44px);
+  padding: var(--sv-space-2) var(--sv-space-3);
+  border: none;
+  border-radius: var(--sv-radius-sm);
+  background: transparent;
+  color: var(--sv-color-text-primary);
+  font: inherit;
+  font-size: var(--sv-font-size-sm);
+  text-align: left;
+  cursor: pointer;
+}
+
+@media (hover: hover) {
+  .item:hover:not(:disabled) {
+    background: var(--sv-color-surface-sunken);
+  }
+}
+
+.item:focus-visible {
+  outline: 2px solid var(--sv-color-focus-ring);
+  outline-offset: -2px;
+}
+
+.item:disabled {
+  opacity: 0.5;
+  cursor: not-allowed;
+}
+
+.itemDestructive {
+  color: var(--sv-color-error-text);
+}
+
+@media (hover: hover) {
+  .itemDestructive:hover:not(:disabled) {
+    background: var(--sv-color-error-surface);
+  }
+}
+
+/* Reserved checkmark gutter for a checkable item — sized so unchecked
+   siblings in the same group still align with the checked one's icon. */
+.check {
+  display: inline-flex;
+  flex-shrink: 0;
+  width: var(--sv-icon-size-sm);
+  height: var(--sv-icon-size-sm);
+  align-items: center;
+  justify-content: center;
+}
+
+.label {
+  padding: var(--sv-space-2) var(--sv-space-3) var(--sv-space-1);
+  font-size: var(--sv-font-size-label);
+  font-weight: var(--sv-font-weight-semibold);
+  color: var(--sv-color-text-muted);
+  text-transform: uppercase;
+  letter-spacing: 0.04em;
+}
+
+.separator {
+  height: 1px;
+  margin: var(--sv-space-1) var(--sv-space-2);
+  background: var(--sv-color-border);
+}

package/dist/NavTabs.module.css

@@ -17,8 +17,10 @@
   transition: color 0.1s ease;
 }
 
-.link:hover {
-  color: var(--sv-color-text-primary);
+@media (hover: hover) {
+  .link:hover {
+    color: var(--sv-color-text-primary);
+  }
 }
 
 .link:focus-visible {

package/dist/OverlayHeader.module.css

@@ -0,0 +1,98 @@
+/* OverlayHeader — shared fixed secondary header for Dialog's mobile mode,
+ * Sheet, and Drawer. Not itself pinned via position — the consumer renders it
+ * as a flex-shrink: 0 sibling before its own scrolling content region (see
+ * the component's own doc comment). */
+
+.header {
+  flex-shrink: 0;
+  background: var(--sv-color-surface);
+  border-bottom: 1px solid var(--sv-color-border);
+}
+
+.row {
+  display: flex;
+  align-items: center;
+  gap: var(--sv-space-2);
+  padding: var(--sv-space-3) var(--sv-space-4);
+}
+
+.backButton {
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  width: var(--sv-touch-target-min, 44px);
+  height: var(--sv-touch-target-min, 44px);
+  flex-shrink: 0;
+  /* Pull the touch-target padding back so the chevron glyph still sits close
+     to the title, matching the visual (not hit-area) spacing of .row's own
+     gap — otherwise a 44px box reads as a large empty gap before the title. */
+  margin-left: calc(-1 * (var(--sv-touch-target-min, 44px) - var(--sv-icon-size-md)) / 2);
+  margin-right: calc(
+    -1 * (var(--sv-touch-target-min, 44px) - var(--sv-icon-size-md)) / 2 + var(--sv-space-1)
+  );
+  border: none;
+  border-radius: var(--sv-radius-md);
+  background: transparent;
+  color: var(--sv-color-text-muted);
+  cursor: pointer;
+}
+
+@media (hover: hover) {
+  .backButton:hover {
+    background: var(--sv-color-surface-sunken);
+    color: var(--sv-color-text-primary);
+  }
+}
+
+.backButton:focus-visible {
+  outline: 2px solid var(--sv-color-focus-ring);
+  outline-offset: -2px;
+}
+
+.title {
+  flex: 1;
+  min-width: 0;
+  overflow: hidden;
+  text-overflow: ellipsis;
+  white-space: nowrap;
+  font-size: var(--sv-font-size-xl);
+  font-weight: var(--sv-font-weight-semibold);
+  color: var(--sv-color-text-primary);
+}
+
+.action {
+  flex-shrink: 0;
+}
+
+.closeButton {
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  width: var(--sv-touch-target-min, 44px);
+  height: var(--sv-touch-target-min, 44px);
+  flex-shrink: 0;
+  /* Pull the touch-target padding back so the × sits flush with the row's own
+     edge padding, same reasoning as .backButton above. */
+  margin-right: calc(-1 * (var(--sv-touch-target-min, 44px) - var(--sv-icon-size-sm)) / 2);
+  border: none;
+  border-radius: var(--sv-radius-md);
+  background: transparent;
+  color: var(--sv-color-text-muted);
+  cursor: pointer;
+}
+
+@media (hover: hover) {
+  .closeButton:hover {
+    background: var(--sv-color-surface-sunken);
+    color: var(--sv-color-text-primary);
+  }
+}
+
+.closeButton:focus-visible {
+  outline: 2px solid var(--sv-color-focus-ring);
+  outline-offset: -2px;
+}
+
+.secondRow {
+  padding: 0 var(--sv-space-2) var(--sv-space-2);
+}

package/dist/Popover.module.css

@@ -11,7 +11,16 @@
   border: 1px solid var(--sv-color-border);
   border-radius: var(--sv-radius-2xl);
   box-shadow: var(--sv-shadow-popover);
-  overflow: hidden;
+  /* auto, not hidden: Popover.tsx applies an inline max-height only when the
+     panel is taller than the room actually available on whichever side it
+     opens (e.g. a tall calendar on a short mobile viewport, where neither
+     above nor below has enough space for the whole thing) — auto lets that
+     capped case scroll internally instead of silently clipping content with
+     no way to reach it. When no max-height is applied (the common case, panel
+     already fits), auto behaves identically to hidden — nothing to scroll,
+     content still clips at the rounded corners exactly as before. */
+  overflow-x: hidden;
+  overflow-y: auto;
   /* Slide in from slightly above */
   animation: sv-popover-in 0.12s ease;
 }
@@ -42,3 +51,24 @@
 .left {
   left: 0;
 }
+
+/* Collision flip: opens above the trigger instead of below, when the panel
+   wouldn't fit within the viewport underneath it (see Popover.tsx's
+   layout-effect measurement). Same slide-in treatment, mirrored to slide up
+   from slightly below instead of down from slightly above. */
+.upward {
+  top: auto;
+  bottom: calc(100% + var(--sv-space-2));
+  animation-name: sv-popover-in-upward;
+}
+
+@keyframes sv-popover-in-upward {
+  from {
+    opacity: 0;
+    transform: translateY(4px);
+  }
+  to {
+    opacity: 1;
+    transform: translateY(0);
+  }
+}

package/dist/SegmentedControl.module.css

@@ -48,6 +48,8 @@
   color: var(--sv-color-text-muted);
 }
 
-.inactive:hover {
-  color: var(--sv-color-text-primary);
+@media (hover: hover) {
+  .inactive:hover {
+    color: var(--sv-color-text-primary);
+  }
 }

package/dist/Select.module.css

@@ -33,6 +33,15 @@
   border-radius: var(--sv-radius-sm);
 }
 
+/* iOS Safari zooms the page when a <select> under 16px receives focus, exactly
+   as it does for text inputs. Lift the default size to >=16px on touch devices;
+   the compact `.sm` variant is for dense desktop tables and is left untouched. */
+@media (pointer: coarse) {
+  .select {
+    font-size: var(--sv-font-size-md);
+  }
+}
+
 .select:focus-visible {
   outline: none;
   border-color: var(--sv-color-accent);

package/dist/Sheet.module.css

@@ -0,0 +1,55 @@
+/* Sheet — fills the same rect as a plugin's content area (between the shell's
+ * sticky header and footer nav — see --sv-shell-header-height /
+ * --sv-shell-footer-height, set by the shell), sliding in from an edge
+ * instead of Dialog's centered box or Drawer's partial-height sheet-over-
+ * scrim. z-index matches Dialog/Drawer's scrim so it layers consistently
+ * with any other overlay. No scrim of its own — see the component doc
+ * comment for why. */
+
+.panel {
+  position: fixed;
+  left: 0;
+  right: 0;
+  top: var(--sv-shell-header-height, 0);
+  bottom: var(--sv-shell-footer-height, 0);
+  z-index: 100;
+  display: flex;
+  flex-direction: column;
+  background: var(--sv-color-surface);
+  outline: none;
+  transform: translateY(100%);
+  transition: transform var(--sv-motion-duration-base) var(--sv-motion-ease-out);
+}
+
+.panelOpen {
+  transform: translateY(0);
+}
+
+/* Opt-in top variant (slideFrom="top") — a short options/actions menu opened
+ * from a header button reads more naturally sliding down from that button's
+ * edge than traveling up from off-screen bottom. :not(.panelOpen) is what
+ * lets this coexist with .panelOpen above despite equal-looking single-class
+ * specificity elsewhere in this file: its (0,2,0) beats .panelOpen's (0,1,0)
+ * while closed/entering/closing, and yields to it (transform: translateY(0),
+ * same value either direction) once open. */
+.panelFromTop:not(.panelOpen) {
+  transform: translateY(-100%);
+}
+
+/* See Dialog.module.css's identical rule for why 0.01ms rather than 0. */
+@media (prefers-reduced-motion: reduce) {
+  .panel {
+    transition-duration: 0.01ms;
+  }
+}
+
+/* Always the scroll container, with or without OverlayHeader present (see
+ * Sheet.tsx). No opinionated padding here — matches Drawer's convention of
+ * leaving horizontal/top padding and safe-area-bottom clearance to the
+ * content itself, since a Sheet's content shape varies far more than a
+ * fixed-size Dialog's. */
+.content {
+  flex: 1 1 auto;
+  overflow-y: auto;
+  overscroll-behavior: contain;
+}