@tamagui/sheet 2.0.0 → 2.1.0

package/src/useKeyboardControllerSheet.ts

@@ -1,26 +1,122 @@
 /**
- * Web stub for keyboard controller sheet hook.
- * Returns no-op values since keyboard-controller is native-only.
+ * Web implementation of the keyboard controller sheet hook.
+ *
+ * Mobile browsers don't expose a keyboard API, but they do resize the
+ * VisualViewport when the soft keyboard opens. We derive the keyboard height as
+ * `getStableLayoutViewportHeight() - visualViewport.height` (see webViewport —
+ * the stable baseline is document.documentElement.clientHeight, NOT innerHeight,
+ * which itself shrinks with the keyboard on real iOS Safari) and feed it into the
+ * keyboardOccludedHeight scroll padding in SheetImplementationCustom.
+ *
+ * Without this, a bottom sheet on mobile web stays pinned behind the keyboard:
+ * react-native-web's Dimensions tracks the (shrinking) VisualViewport, so any
+ * content sized off window dimensions collapses while the sheet's bottom stays
+ * occluded. See SheetImplementationCustom's activePositions / keyboardOccludedHeight.
  */
 
-import { useRef } from 'react'
+import { useCallback, useEffect, useRef, useState } from 'react'
+import { isWeb } from '@tamagui/constants'
 import type {
   KeyboardControllerSheetOptions,
   KeyboardControllerSheetResult,
 } from './types'
-
-const noop = () => {}
+import {
+  getWebKeyboardHeight,
+  isEditableElement,
+  MIN_KEYBOARD_HEIGHT,
+} from './webViewport'
 
 export function useKeyboardControllerSheet(
-  _options: KeyboardControllerSheetOptions
+  options: KeyboardControllerSheetOptions
 ): KeyboardControllerSheetResult {
+  const { enabled } = options
+
+  const [keyboardHeight, setKeyboardHeight] = useState(0)
+  const [isKeyboardVisible, setIsKeyboardVisible] = useState(false)
+
+  // action-sheet pattern: pause keyboard hide events during drag so the sheet
+  // position doesn't revert mid-gesture when a TextInput blurs.
   const pauseKeyboardHandler = useRef(false)
+  const pendingHide = useRef(false)
+  // live mirror of isKeyboardVisible so the listener can read it without
+  // re-subscribing on every toggle.
+  const isVisibleRef = useRef(false)
+  isVisibleRef.current = isKeyboardVisible
+
+  const dismissKeyboard = useCallback(() => {
+    if (typeof document === 'undefined') return
+    const active = document.activeElement as HTMLElement | null
+    if (isEditableElement(active)) {
+      active?.blur?.()
+    }
+  }, [])
+
+  const flushPendingHide = useCallback(() => {
+    if (pendingHide.current) {
+      pendingHide.current = false
+      setIsKeyboardVisible(false)
+      setKeyboardHeight(0)
+    }
+  }, [])
+
+  useEffect(() => {
+    if (!isWeb || !enabled) return
+    if (typeof window === 'undefined') return
+    const vv = window.visualViewport
+    if (!vv) return
+
+    const update = () => {
+      const height = getWebKeyboardHeight()
+      const tall = height >= MIN_KEYBOARD_HEIGHT
+      // require an editable element focused to *show* — this rules out URL-bar
+      // collapse and other viewport changes that aren't a keyboard. but stay
+      // visible while the viewport remains shrunk even if focus momentarily
+      // moves to a non-editable element (e.g. tapping between two inputs fires
+      // focusout→focusin), so the sheet doesn't flicker mid-transition.
+      const editableFocused = isEditableElement(document.activeElement)
+      const visible = tall && (editableFocused || isVisibleRef.current)
+
+      if (!visible) {
+        // suppress hide during an active drag so positions stay frozen; the
+        // drag-end flush reconciles the real state.
+        if (pauseKeyboardHandler.current && isVisibleRef.current) {
+          pendingHide.current = true
+          return
+        }
+        setIsKeyboardVisible(false)
+        setKeyboardHeight(0)
+        return
+      }
+
+      pendingHide.current = false
+      setIsKeyboardVisible(true)
+      setKeyboardHeight((prev) => (prev === height ? prev : height))
+    }
+
+    // only react to resize (keyboard height changes). we intentionally do NOT
+    // listen to visualViewport 'scroll' — that fires continuously while the
+    // sheet content scrolls and would re-derive the keyboard height from a
+    // shifting viewport, making the sheet jump.
+    vv.addEventListener('resize', update)
+    // focus changes flip editable state without necessarily resizing the viewport
+    window.addEventListener('focusin', update)
+    window.addEventListener('focusout', update)
+
+    update()
+
+    return () => {
+      vv.removeEventListener('resize', update)
+      window.removeEventListener('focusin', update)
+      window.removeEventListener('focusout', update)
+    }
+  }, [enabled])
+
   return {
     keyboardControllerEnabled: false,
-    keyboardHeight: 0,
-    isKeyboardVisible: false,
-    dismissKeyboard: noop,
+    keyboardHeight,
+    isKeyboardVisible,
+    dismissKeyboard,
     pauseKeyboardHandler,
-    flushPendingHide: noop,
+    flushPendingHide,
   }
 }

package/src/useSheetProviderProps.tsx

@@ -9,6 +9,22 @@ import type { SheetOpenState } from './useSheetOpenState'
 
 export type SheetContextValue = ReturnType<typeof useSheetProviderProps> & {
   keyboardOccludedHeight: number
+  // whether the soft keyboard is currently open. distinct from
+  // keyboardOccludedHeight (which is 0 once the sheet fits above the keyboard):
+  // the fit-mode height freeze must persist for the whole time the keyboard is
+  // open, not just while occluded, or it releases and the sheet collapses.
+  isKeyboardVisible: boolean
+  // the sheet's authoritative pre-keyboard frame height (web). SheetScrollView
+  // pins its height to this while the keyboard is open so the frame stays its
+  // full size (anchored to the screen bottom) instead of collapsing to a
+  // consumer maxHeight that shrank with the viewport. 0 when not applicable.
+  keyboardStableFrameHeight: number
+  // AUTOFOCUS-ON-OPEN seed phase (web). while reconstructing the pre-keyboard
+  // baseline, SheetScrollView must UNCLIP (apply keyboardStableFrameHeight as
+  // maxHeight only, not a fixed height) so it sizes to its content and the sheet
+  // can measure the true content height. once settled the fixed-height pin
+  // applies. false outside the seed window.
+  isKeyboardSeeding: boolean
   setHasScrollView: (val: boolean) => void
 }
 

package/src/useSheetScrollViewGestures.ts

@@ -75,6 +75,10 @@ export function useSheetScrollViewGestures({
       }
 
       scrollBridge.scrollStartY = touch.pageY
+      // claim this touch for the scroll-view gesture hook so the PanResponder
+      // (which also negotiates this touch via RNW's responder system) defers
+      // and doesn't double-drive the sheet position. cleared on touchend.
+      scrollBridge.scrollNodeTouched = true
     }
 
     const handleTouchMove = (e: TouchEvent) => {
@@ -115,6 +119,10 @@ export function useSheetScrollViewGestures({
         if (newOwner === 'pan') {
           s.panDragOffset = 0
           s.dys = []
+          // re-baseline the pan origin to the sheet's CURRENT position so the
+          // offset (reset to 0 here) maps to where it actually is — required for
+          // a correct scroll→pan handoff now that the PanResponder defers to us.
+          scrollBridge.startPanDrag?.()
           scrollBridge.setParentDragging(true)
           disableScroll()
         } else {
@@ -133,8 +141,13 @@ export function useSheetScrollViewGestures({
 
         s.dys.push(dy)
         if (s.dys.length > 100) s.dys = s.dys.slice(-10)
-      } else if (s.owner === 'scroll') {
-        // programmatic scroll for synthetic events
+      } else if (s.owner === 'scroll' && !e.isTrusted) {
+        // SYNTHETIC events only (tests): dispatched TouchEvents don't trigger the
+        // browser's native overflow scroll, so we move scrollTop ourselves. for a
+        // REAL touch (e.isTrusted) the browser already scrolls the overflow
+        // container natively — doing it again here double-applies the delta and
+        // makes scrollTop jitter / snap around. so for real touches we let native
+        // scrolling own it and only track the offset via the ScrollView onScroll.
         const scrollDelta = -dy
         const maxScrollY = node.scrollHeight - node.clientHeight
         const newScrollY = Math.max(0, Math.min(maxScrollY, currentScrollY + scrollDelta))
@@ -159,12 +172,20 @@ export function useSheetScrollViewGestures({
         }
 
         scrollBridge.release({ dragAt: s.panDragOffset, vy })
+      } else if (s.owner === 'scroll') {
+        // gesture ended while scrolling. a pan→scroll handoff only happens once
+        // the pane reached the top, so commit the top snap (index 0) and clear
+        // the dragging state HERE, on touchend — never mid-gesture (that would
+        // fight the live gesture). this replaces the PanResponder's release,
+        // which used to fire on touchend before it deferred to this hook.
+        scrollBridge.snapToPosition?.(0)
       }
 
       enableScroll()
       s.owner = 'none'
       s.panDragOffset = 0
       s.dys = []
+      scrollBridge.scrollNodeTouched = false
     }
 
     node.addEventListener('touchstart', handleTouchStart, {

package/src/webViewport.ts

@@ -0,0 +1,52 @@
+/**
+ * Web (mobile-browser) viewport helpers for the Sheet's keyboard handling.
+ *
+ * On real iOS Safari (verified on-device, iOS 26) the soft keyboard shrinks
+ * BOTH `window.visualViewport.height` AND `window.innerHeight` — neither is the
+ * stable layout viewport. Measured during a keyboard open: visualViewport
+ * 714 -> 404, innerHeight 714 -> 561 (it wobbles), but
+ * `document.documentElement.clientHeight` holds rock-steady at 714 the whole
+ * time (open, mid-keyboard, and close). So clientHeight IS the stable layout
+ * viewport, and we derive everything from it:
+ *   - soft-keyboard height = clientHeight - visualViewport.height (stays correct
+ *     even as innerHeight drifts), so the scroll padding clears the input.
+ *   - the sheet's fit-mode anchor cap (translateY = screenSize - frameSize) reads
+ *     clientHeight, so it never re-measures against a shrunk value and the frame
+ *     stays anchored at the bottom.
+ */
+
+// ignore small viewport changes (URL bar collapse, accessory bars) so they
+// don't read as a full keyboard. a real soft keyboard is well above this.
+export const MIN_KEYBOARD_HEIGHT = 80
+
+export function isEditableElement(el: Element | null): boolean {
+  if (!el) return false
+  const tag = el.tagName
+  if (tag === 'INPUT' || tag === 'TEXTAREA' || tag === 'SELECT') return true
+  if ((el as HTMLElement).isContentEditable) return true
+  return false
+}
+
+/**
+ * The stable layout-viewport height. document.documentElement.clientHeight is
+ * unaffected by the soft keyboard on iOS Safari (unlike innerHeight /
+ * visualViewport), so it stays constant while the keyboard animates in/out.
+ */
+export function getStableLayoutViewportHeight(): number {
+  if (typeof window === 'undefined') return 0
+  const ch = typeof document !== 'undefined' ? document.documentElement?.clientHeight : 0
+  if (ch && ch > 0) return ch
+  // fallback when clientHeight is unavailable (SSR / detached): best effort
+  return Math.max(window.innerHeight || 0, window.visualViewport?.height || 0)
+}
+
+/**
+ * Soft-keyboard height = the occluded region between the (stable) layout
+ * viewport bottom and the visual viewport bottom.
+ */
+export function getWebKeyboardHeight(): number {
+  if (typeof window === 'undefined') return 0
+  const vv = window.visualViewport
+  if (!vv) return 0
+  return Math.max(0, Math.round(getStableLayoutViewportHeight() - vv.height))
+}

package/types/SheetContext.d.ts

@@ -33,6 +33,9 @@ export declare const SheetProvider: (props: {
     onlyShowFrame: boolean;
 } & {
     keyboardOccludedHeight: number;
+    isKeyboardVisible: boolean;
+    keyboardStableFrameHeight: number;
+    isKeyboardSeeding: boolean;
     setHasScrollView: (val: boolean) => void;
 } & {
     scope: import("@tamagui/create-context").Scope<SheetContextValue>;

package/types/SheetContext.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SheetContext.d.ts","sourceRoot":"","sources":["../src/SheetContext.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAA;AAEhE,eAAO,MAAO,kBAAkB;;;2JAM4rB,CAAC;QAAS,CAAC;YAAoB,CAAC;yBAN1tB,gBAAgB,+CAAkC,CAAA;AAEpF,eAAO,MAAO,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;+CAAE,eAAe;;;mCAG3C,CAAA"}
+{"version":3,"file":"SheetContext.d.ts","sourceRoot":"","sources":["../src/SheetContext.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAA;AAEhE,eAAO,MAAO,kBAAkB;;;2JAM4rB,CAAC;QAAS,CAAC;YAAoB,CAAC;yBAN1tB,gBAAgB,+CAAkC,CAAA;AAEpF,eAAO,MAAO,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;+CAAE,eAAe;;;mCAG3C,CAAA"}

package/types/SheetImplementationCustom.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SheetImplementationCustom.d.ts","sourceRoot":"","sources":["../src/SheetImplementationCustom.tsx"],"names":[],"mappings":"AAcA,OAAO,KAAmB,MAAM,OAAO,CAAA;AAOvC,OAAO,EAA4B,IAAI,EAAE,MAAM,cAAc,CAAA;AAQ7D,OAAO,KAAK,EAAc,cAAc,EAAE,MAAM,SAAS,CAAA;AA8BzD,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;8BAgzBrC,CAAA"}
+{"version":3,"file":"SheetImplementationCustom.d.ts","sourceRoot":"","sources":["../src/SheetImplementationCustom.tsx"],"names":[],"mappings":"AAcA,OAAO,KAAmB,MAAM,OAAO,CAAA;AAOvC,OAAO,EAA4B,IAAI,EAAE,MAAM,cAAc,CAAA;AAa7D,OAAO,KAAK,EAAc,cAAc,EAAE,MAAM,SAAS,CAAA;AA2CzD,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;8BAkhCrC,CAAA"}

package/types/SheetScrollView.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SheetScrollView.d.ts","sourceRoot":"","sources":["../src/SheetScrollView.tsx"],"names":[],"mappings":"AAKA,OAAO,KAAsC,MAAM,OAAO,CAAA;AAC1D,OAAO,KAAK,EAAE,UAAU,IAAI,YAAY,EAAE,MAAM,cAAc,CAAA;AAS9D,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wCA6M3B,CAAA"}
+{"version":3,"file":"SheetScrollView.d.ts","sourceRoot":"","sources":["../src/SheetScrollView.tsx"],"names":[],"mappings":"AAKA,OAAO,KAAsC,MAAM,OAAO,CAAA;AAC1D,OAAO,KAAK,EAAE,UAAU,IAAI,YAAY,EAAE,MAAM,cAAc,CAAA;AAU9D,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wCAmP3B,CAAA"}

package/types/nativeSheet.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"nativeSheet.d.ts","sourceRoot":"","sources":["../src/nativeSheet.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,OAAO,CAAA;AAI9C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAA;AAMzC,KAAK,oBAAoB,GAAG,KAAK,CAAA;AAMjC,wBAAgB,cAAc,CAAC,QAAQ,EAAE,oBAAoB,wCAE5D;AAED,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,oBAAoB,EAC9B,UAAU,EAAE;IAAE,cAAc,EAAE,GAAG,CAAC;IAAC,yBAAyB,EAAE,GAAG,CAAA;CAAE,QAkEpE"}
+{"version":3,"file":"nativeSheet.d.ts","sourceRoot":"","sources":["../src/nativeSheet.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,OAAO,CAAA;AAI9C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAA;AAMzC,KAAK,oBAAoB,GAAG,KAAK,CAAA;AAMjC,wBAAgB,cAAc,CAAC,QAAQ,EAAE,oBAAoB,wCAE5D;AAED,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,oBAAoB,EAC9B,UAAU,EAAE;IAAE,cAAc,EAAE,GAAG,CAAC;IAAC,yBAAyB,EAAE,GAAG,CAAA;CAAE,QAqEpE"}

package/types/types.d.ts

@@ -62,7 +62,8 @@ export type SheetProps = ScopedProps<{
     zIndex?: number;
     portalProps?: PortalProps;
     /**
-     * Native-only flag that will make the sheet move up when the mobile keyboard opens so the focused input remains visible
+     * Makes the sheet move up when the mobile keyboard opens so the focused input remains visible.
+     * Works on native (via keyboard events) and on mobile web (via the VisualViewport API).
      */
     moveOnKeyboardChange?: boolean;
     containerComponent?: React.ComponentType<any>;
@@ -104,6 +105,8 @@ export type ScrollBridge = {
     forceScrollTo?: (y: number) => void;
     isAtTop?: boolean;
     snapToPosition?: (positionIndex: number) => void;
+    startPanDrag?: () => void;
+    scrollNodeTouched?: boolean;
 };
 export interface KeyboardControllerSheetOptions {
     /**

package/types/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.tsx"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.tsx"],"names":[],"mappings":"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"}

package/types/useKeyboardControllerSheet.d.ts

@@ -1,7 +1,18 @@
 /**
- * Web stub for keyboard controller sheet hook.
- * Returns no-op values since keyboard-controller is native-only.
+ * Web implementation of the keyboard controller sheet hook.
+ *
+ * Mobile browsers don't expose a keyboard API, but they do resize the
+ * VisualViewport when the soft keyboard opens. We derive the keyboard height as
+ * `getStableLayoutViewportHeight() - visualViewport.height` (see webViewport —
+ * the stable baseline is document.documentElement.clientHeight, NOT innerHeight,
+ * which itself shrinks with the keyboard on real iOS Safari) and feed it into the
+ * keyboardOccludedHeight scroll padding in SheetImplementationCustom.
+ *
+ * Without this, a bottom sheet on mobile web stays pinned behind the keyboard:
+ * react-native-web's Dimensions tracks the (shrinking) VisualViewport, so any
+ * content sized off window dimensions collapses while the sheet's bottom stays
+ * occluded. See SheetImplementationCustom's activePositions / keyboardOccludedHeight.
  */
 import type { KeyboardControllerSheetOptions, KeyboardControllerSheetResult } from './types';
-export declare function useKeyboardControllerSheet(_options: KeyboardControllerSheetOptions): KeyboardControllerSheetResult;
+export declare function useKeyboardControllerSheet(options: KeyboardControllerSheetOptions): KeyboardControllerSheetResult;
 //# sourceMappingURL=useKeyboardControllerSheet.d.ts.map

package/types/useKeyboardControllerSheet.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useKeyboardControllerSheet.d.ts","sourceRoot":"","sources":["../src/useKeyboardControllerSheet.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EACV,8BAA8B,EAC9B,6BAA6B,EAC9B,MAAM,SAAS,CAAA;AAIhB,wBAAgB,0BAA0B,CACxC,QAAQ,EAAE,8BAA8B,GACvC,6BAA6B,CAU/B"}
+{"version":3,"file":"useKeyboardControllerSheet.d.ts","sourceRoot":"","sources":["../src/useKeyboardControllerSheet.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAIH,OAAO,KAAK,EACV,8BAA8B,EAC9B,6BAA6B,EAC9B,MAAM,SAAS,CAAA;AAOhB,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,8BAA8B,GACtC,6BAA6B,CA2F/B"}

package/types/useSheetProviderProps.d.ts

@@ -4,6 +4,9 @@ import type { ScrollBridge, SheetProps } from './types';
 import type { SheetOpenState } from './useSheetOpenState';
 export type SheetContextValue = ReturnType<typeof useSheetProviderProps> & {
     keyboardOccludedHeight: number;
+    isKeyboardVisible: boolean;
+    keyboardStableFrameHeight: number;
+    isKeyboardSeeding: boolean;
     setHasScrollView: (val: boolean) => void;
 };
 export declare function useSheetProviderProps(props: SheetProps, state: SheetOpenState, options?: {

package/types/useSheetProviderProps.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useSheetProviderProps.d.ts","sourceRoot":"","sources":["../src/useSheetProviderProps.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AACzB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAA;AAKnD,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,SAAS,CAAA;AACvD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA;AAEzD,MAAM,MAAM,iBAAiB,GAAG,UAAU,CAAC,OAAO,qBAAqB,CAAC,GAAG;IACzE,sBAAsB,EAAE,MAAM,CAAA;IAC9B,gBAAgB,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,IAAI,CAAA;CACzC,CAAA;AAED,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,UAAU,EACjB,KAAK,EAAE,cAAc,EACrB,OAAO,GAAE;IACP,kBAAkB,CAAC,EAAE,CAAC,IAAI,EAAE,GAAG,KAAK,IAAI,CAAA;CACpC;;;;;;;;;;;;;;;gCADwB,GAAG,KAAK,IAAI;;;;;;;wBAoCjC,MAAM;;;EAyKhB"}
+{"version":3,"file":"useSheetProviderProps.d.ts","sourceRoot":"","sources":["../src/useSheetProviderProps.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AACzB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAA;AAKnD,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,SAAS,CAAA;AACvD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA;AAEzD,MAAM,MAAM,iBAAiB,GAAG,UAAU,CAAC,OAAO,qBAAqB,CAAC,GAAG;IACzE,sBAAsB,EAAE,MAAM,CAAA;IAK9B,iBAAiB,EAAE,OAAO,CAAA;IAK1B,yBAAyB,EAAE,MAAM,CAAA;IAMjC,iBAAiB,EAAE,OAAO,CAAA;IAC1B,gBAAgB,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,IAAI,CAAA;CACzC,CAAA;AAED,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,UAAU,EACjB,KAAK,EAAE,cAAc,EACrB,OAAO,GAAE;IACP,kBAAkB,CAAC,EAAE,CAAC,IAAI,EAAE,GAAG,KAAK,IAAI,CAAA;CACpC;;;;;;;;;;;;;;;gCADwB,GAAG,KAAK,IAAI;;;;;;;wBAoCjC,MAAM;;;EAyKhB"}

package/types/useSheetScrollViewGestures.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useSheetScrollViewGestures.d.ts","sourceRoot":"","sources":["../src/useSheetScrollViewGestures.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,IAAI,YAAY,EAAE,MAAM,cAAc,CAAA;AAC9D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AAa3C,UAAU,+BAA+B;IACvC,SAAS,EAAE,KAAK,CAAC,SAAS,CAAC,YAAY,GAAG,IAAI,CAAC,CAAA;IAC/C,YAAY,EAAE,YAAY,CAAA;IAC1B,oBAAoB,EAAE,OAAO,CAAA;IAC7B,aAAa,EAAE,OAAO,CAAA;IACtB,gBAAgB,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,MAAM,KAAK,IAAI,CAAA;CAC9D;AAED,wBAAgB,0BAA0B,CAAC,EACzC,SAAS,EACT,YAAY,EACZ,oBAAoB,GACrB,EAAE,+BAA+B,MAsKjC"}
+{"version":3,"file":"useSheetScrollViewGestures.d.ts","sourceRoot":"","sources":["../src/useSheetScrollViewGestures.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,IAAI,YAAY,EAAE,MAAM,cAAc,CAAA;AAC9D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AAa3C,UAAU,+BAA+B;IACvC,SAAS,EAAE,KAAK,CAAC,SAAS,CAAC,YAAY,GAAG,IAAI,CAAC,CAAA;IAC/C,YAAY,EAAE,YAAY,CAAA;IAC1B,oBAAoB,EAAE,OAAO,CAAA;IAC7B,aAAa,EAAE,OAAO,CAAA;IACtB,gBAAgB,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,MAAM,KAAK,IAAI,CAAA;CAC9D;AAED,wBAAgB,0BAA0B,CAAC,EACzC,SAAS,EACT,YAAY,EACZ,oBAAoB,GACrB,EAAE,+BAA+B,MA2LjC"}

package/types/webViewport.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Web (mobile-browser) viewport helpers for the Sheet's keyboard handling.
+ *
+ * On real iOS Safari (verified on-device, iOS 26) the soft keyboard shrinks
+ * BOTH `window.visualViewport.height` AND `window.innerHeight` — neither is the
+ * stable layout viewport. Measured during a keyboard open: visualViewport
+ * 714 -> 404, innerHeight 714 -> 561 (it wobbles), but
+ * `document.documentElement.clientHeight` holds rock-steady at 714 the whole
+ * time (open, mid-keyboard, and close). So clientHeight IS the stable layout
+ * viewport, and we derive everything from it:
+ *   - soft-keyboard height = clientHeight - visualViewport.height (stays correct
+ *     even as innerHeight drifts), so the scroll padding clears the input.
+ *   - the sheet's fit-mode anchor cap (translateY = screenSize - frameSize) reads
+ *     clientHeight, so it never re-measures against a shrunk value and the frame
+ *     stays anchored at the bottom.
+ */
+export declare const MIN_KEYBOARD_HEIGHT = 80;
+export declare function isEditableElement(el: Element | null): boolean;
+/**
+ * The stable layout-viewport height. document.documentElement.clientHeight is
+ * unaffected by the soft keyboard on iOS Safari (unlike innerHeight /
+ * visualViewport), so it stays constant while the keyboard animates in/out.
+ */
+export declare function getStableLayoutViewportHeight(): number;
+/**
+ * Soft-keyboard height = the occluded region between the (stable) layout
+ * viewport bottom and the visual viewport bottom.
+ */
+export declare function getWebKeyboardHeight(): number;
+//# sourceMappingURL=webViewport.d.ts.map

package/types/webViewport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"webViewport.d.ts","sourceRoot":"","sources":["../src/webViewport.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAIH,eAAO,MAAM,mBAAmB,KAAK,CAAA;AAErC,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,OAAO,GAAG,IAAI,GAAG,OAAO,CAM7D;AAED;;;;GAIG;AACH,wBAAgB,6BAA6B,IAAI,MAAM,CAMtD;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,IAAI,MAAM,CAK7C"}