@multiplatform.one/forms 7.45.1 → 7.46.0

package/src/shared/interactionHooks.spec.tsx

@@ -61,6 +61,19 @@ describe("useSheetEscapeDismiss", () => {
     expect(second).toHaveBeenCalledTimes(1);
   });
 
+  it("listens on document when asked, so a document-level stopPropagation cannot block it", () => {
+    const onDismiss = vi.fn();
+    const stop = (event: Event) => event.stopPropagation();
+    document.addEventListener("keydown", stop);
+    try {
+      renderHook(() => useSheetEscapeDismiss(true, onDismiss, "document"));
+      document.dispatchEvent(new KeyboardEvent("keydown", { key: "Escape", bubbles: true }));
+      expect(onDismiss).toHaveBeenCalledTimes(1);
+    } finally {
+      document.removeEventListener("keydown", stop);
+    }
+  });
+
   it("detaches the listener on unmount", () => {
     const onDismiss = vi.fn();
     const { unmount } = renderHook(() => useSheetEscapeDismiss(true, onDismiss));

package/src/shared/useSheetEscapeDismiss.ts

@@ -11,7 +11,11 @@ import { isWeb } from "tamagui";
  * comboboxes) that own Escape call stopPropagation()/preventDefault() and
  * keep the sheet open.
  */
-export function useSheetEscapeDismiss(enabled: boolean, onDismiss: () => void) {
+export function useSheetEscapeDismiss(
+  enabled: boolean,
+  onDismiss: () => void,
+  target: "window" | "document" = "window",
+) {
   const onDismissRef = useRef(onDismiss);
   onDismissRef.current = onDismiss;
   useEffect(() => {
@@ -20,7 +24,8 @@ export function useSheetEscapeDismiss(enabled: boolean, onDismiss: () => void) {
       if (event.key !== "Escape" || event.defaultPrevented) return;
       onDismissRef.current();
     };
-    window.addEventListener("keydown", onKeyDown);
-    return () => window.removeEventListener("keydown", onKeyDown);
-  }, [enabled]);
+    const node = target === "document" ? document : window;
+    node.addEventListener("keydown", onKeyDown as EventListener);
+    return () => node.removeEventListener("keydown", onKeyDown as EventListener);
+  }, [enabled, target]);
 }

package/types/FloatingPanel/index.d.ts

@@ -11,6 +11,14 @@ export interface FloatingPanelProps {
     /** Suppress delayed trigger focus when a consumer handles close focus itself. Web only. */
     skipReturnFocusRef?: RefObject<boolean>;
     trigger: ReactNode;
+    anchorMode?: "cover-trigger" | "attach";
+    triggerRow?: ReactNode;
+    anchorRect?: {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    };
     triggerEcho?: boolean;
     /**
      * Optional control rendered beside the trigger but OUTSIDE the native press
@@ -117,7 +125,7 @@ export interface FloatingPanelProps {
      * COVER-TRIGGER (LC-105): the panel's top edge sits on the trigger's TOP
      * edge instead of attaching below it, so the trigger becomes the panel's
      * first row by default. Set triggerEcho=false for a custom first row. The panel scales from
-     * the trigger's top start corner. Dropping up, the bottom edges coincide.
+     * the trigger's top start corner. Viewport collisions use the bottom sheet.
      * Enabled by default. Web float only; the native and narrow-web sheet is unchanged.
      */
     cover?: boolean;

package/types/FloatingPanel/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/FloatingPanel/index.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAW,MAAM,OAAO,CAAC;AAwB3D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAezD,OAAO,EAAE,wBAAwB,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAG/E,OAAO,EACL,gBAAgB,EAChB,sBAAsB,EACtB,iBAAiB,EACjB,eAAe,EACf,oBAAoB,EACpB,iBAAiB,EACjB,qBAAqB,GACtB,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EACV,cAAc,EACd,uBAAuB,EACvB,sBAAsB,GACvB,MAAM,oBAAoB,CAAC;AAI5B,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,OAAO,CAAC;IACd,YAAY,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;IACtC,4EAA4E;IAC5E,YAAY,CAAC,EAAE,MAAM,IAAI,CAAC;IAC1B,2FAA2F;IAC3F,kBAAkB,CAAC,EAAE,SAAS,CAAC,OAAO,CAAC,CAAC;IACxC,OAAO,EAAE,SAAS,CAAC;IACnB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB;;;;;OAKG;IACH,UAAU,CAAC,EAAE,SAAS,CAAC;IACvB,QAAQ,EAAE,SAAS,CAAC;IACpB;;;;;;;;OAQG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;;;OAIG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB;;;;;;OAMG;IACH,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACzB;;;;;;OAMG;IACH,SAAS,CAAC,EAAE,cAAc,CAAC;IAC3B;;;;OAIG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB;;;;OAIG;IACH,cAAc,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;OAGG;IACH,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB;;;;;;;OAOG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;;OAEG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC1C;;;;;OAKG;IACH,WAAW,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAChE;;;OAGG;IACH,aAAa,CAAC,EAAE,SAAS,GAAG,SAAS,CAAC;IACtC;;;;;;;;OAQG;IACH,MAAM,CAAC,EAAE,OAAO,GAAG,aAAa,CAAC;IACjC;;;;;;OAMG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AA2LD,wBAAgB,eAAe,YAE9B;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,kBAAkB,2CActD"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/FloatingPanel/index.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAW,MAAM,OAAO,CAAC;AA2B3D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAezD,OAAO,EAAE,wBAAwB,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAG/E,OAAO,EACL,gBAAgB,EAChB,sBAAsB,EACtB,iBAAiB,EACjB,eAAe,EACf,oBAAoB,EACpB,iBAAiB,EACjB,qBAAqB,GACtB,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EACV,cAAc,EACd,uBAAuB,EACvB,sBAAsB,GACvB,MAAM,oBAAoB,CAAC;AAI5B,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,OAAO,CAAC;IACd,YAAY,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;IACtC,4EAA4E;IAC5E,YAAY,CAAC,EAAE,MAAM,IAAI,CAAC;IAC1B,2FAA2F;IAC3F,kBAAkB,CAAC,EAAE,SAAS,CAAC,OAAO,CAAC,CAAC;IACxC,OAAO,EAAE,SAAS,CAAC;IACnB,UAAU,CAAC,EAAE,eAAe,GAAG,QAAQ,CAAC;IACxC,UAAU,CAAC,EAAE,SAAS,CAAC;IACvB,UAAU,CAAC,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IACrE,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB;;;;;OAKG;IACH,UAAU,CAAC,EAAE,SAAS,CAAC;IACvB,QAAQ,EAAE,SAAS,CAAC;IACpB;;;;;;;;OAQG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;;;OAIG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB;;;;;;OAMG;IACH,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACzB;;;;;;OAMG;IACH,SAAS,CAAC,EAAE,cAAc,CAAC;IAC3B;;;;OAIG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB;;;;OAIG;IACH,cAAc,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;OAGG;IACH,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB;;;;;;;OAOG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;;OAEG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC1C;;;;;OAKG;IACH,WAAW,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAChE;;;OAGG;IACH,aAAa,CAAC,EAAE,SAAS,GAAG,SAAS,CAAC;IACtC;;;;;;;;OAQG;IACH,MAAM,CAAC,EAAE,OAAO,GAAG,aAAa,CAAC;IACjC;;;;;;OAMG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAgPD,wBAAgB,eAAe,YAE9B;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,kBAAkB,2CAkBtD"}

package/types/shared/focusManagement.d.ts

@@ -6,9 +6,9 @@
  * only remembers a `Dialog.Trigger` mounted inside the Dialog. These hooks
  * close that gap:
  *
- * - `useReturnFocusOnClose(open)` — capture the focused element when `open`
- *   flips true; when it flips false, return focus to it IF focus was dropped
- *   (on body, or stranded inside a hidden/removed overlay). Never steals
+ * - `useReturnFocusOnClose(open, skip?, insideRef?)` — capture the focused
+ *   element when `open` flips true; when it flips false, return focus to it
+ *   IF focus was dropped (on body, or stranded inside the closing overlay). Never steals
  *   focus the user deliberately moved elsewhere (outside-click onto another
  *   control).
  * - `useSheetModalFocus(open, frameRef)` — sheet-mode complement: also moves
@@ -34,8 +34,13 @@
  * Web-only; both are no-ops on native.
  */
 import { type RefObject } from "react";
-/** Restore focus to the element focused at open time, on close (web only). */
-export declare function useReturnFocusOnClose(open: boolean, skipReturnFocusRef?: RefObject<boolean>): void;
+/**
+ * Restore focus to the element focused at open time, on close (web only).
+ * `insideRef` is the closing overlay's frame: focus still inside it counts as
+ * dropped, because it falls to <body> when the frame unmounts after the exit
+ * and no retry runs that late.
+ */
+export declare function useReturnFocusOnClose(open: boolean, skipReturnFocusRef?: RefObject<boolean>, insideRef?: RefObject<HTMLElement | null>): void;
 /**
  * Sheet-mode modal focus: on open, move focus into the frame (frame itself is
  * the target — it must carry `tabIndex={-1}`); while open, trap Tab inside;

package/types/shared/focusManagement.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"focusManagement.d.ts","sourceRoot":"","sources":["../../src/shared/focusManagement.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AAEH,OAAO,EAAqB,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AA8D1D,8EAA8E;AAC9E,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,OAAO,EAAE,kBAAkB,CAAC,EAAE,SAAS,CAAC,OAAO,CAAC,QAgB3F;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,OAAO,EACb,QAAQ,EAAE,SAAS,CAAC,WAAW,GAAG,IAAI,CAAC,EACvC,kBAAkB,CAAC,EAAE,SAAS,CAAC,OAAO,CAAC,QA+DxC;AAID;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,CAAC,eAAe,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,QAWzE;AAED,wEAAwE;AACxE,wBAAgB,eAAe,CAAC,EAC9B,eAAe,GAChB,EAAE;IACD,eAAe,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CACzC,GAAG,IAAI,CAGP"}
+{"version":3,"file":"focusManagement.d.ts","sourceRoot":"","sources":["../../src/shared/focusManagement.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AAEH,OAAO,EAAqB,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AA8D1D;;;;;GAKG;AACH,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,OAAO,EACb,kBAAkB,CAAC,EAAE,SAAS,CAAC,OAAO,CAAC,EACvC,SAAS,CAAC,EAAE,SAAS,CAAC,WAAW,GAAG,IAAI,CAAC,QAiB1C;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,OAAO,EACb,QAAQ,EAAE,SAAS,CAAC,WAAW,GAAG,IAAI,CAAC,EACvC,kBAAkB,CAAC,EAAE,SAAS,CAAC,OAAO,CAAC,QA+DxC;AAID;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,CAAC,eAAe,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,QAWzE;AAED,wEAAwE;AACxE,wBAAgB,eAAe,CAAC,EAC9B,eAAe,GAChB,EAAE;IACD,eAAe,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CACzC,GAAG,IAAI,CAGP"}

package/types/shared/useSheetEscapeDismiss.d.ts

@@ -8,5 +8,5 @@
  * comboboxes) that own Escape call stopPropagation()/preventDefault() and
  * keep the sheet open.
  */
-export declare function useSheetEscapeDismiss(enabled: boolean, onDismiss: () => void): void;
+export declare function useSheetEscapeDismiss(enabled: boolean, onDismiss: () => void, target?: "window" | "document"): void;
 //# sourceMappingURL=useSheetEscapeDismiss.d.ts.map

package/types/shared/useSheetEscapeDismiss.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useSheetEscapeDismiss.d.ts","sourceRoot":"","sources":["../../src/shared/useSheetEscapeDismiss.ts"],"names":[],"mappings":"AAGA;;;;;;;;;GASG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,IAAI,QAY5E"}
+{"version":3,"file":"useSheetEscapeDismiss.d.ts","sourceRoot":"","sources":["../../src/shared/useSheetEscapeDismiss.ts"],"names":[],"mappings":"AAGA;;;;;;;;;GASG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,OAAO,EAChB,SAAS,EAAE,MAAM,IAAI,EACrB,MAAM,GAAE,QAAQ,GAAG,UAAqB,QAczC"}