@multiplatform.one/forms 7.49.1 → 7.49.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@multiplatform.one/forms",
-  "version": "7.49.1",
+  "version": "7.49.3",
   "description": "Cross-platform form components with URL state management",
   "keywords": [
     "cross-platform",
@@ -57,10 +57,10 @@
   },
   "dependencies": {
     "@floating-ui/react": "^0.27.20",
-    "@multiplatform.one/platform": "^7.49.1",
-    "@multiplatform.one/router": "^7.49.1",
-    "@multiplatform.one/table-primitives": "^7.49.1",
-    "@multiplatform.one/theme": "^7.49.1",
+    "@multiplatform.one/platform": "^7.49.3",
+    "@multiplatform.one/router": "^7.49.3",
+    "@multiplatform.one/table-primitives": "^7.49.3",
+    "@multiplatform.one/theme": "^7.49.3",
     "@phosphor-icons/react": "^2.1.10",
     "@tamagui/get-font-sized": "2.7.6",
     "@tamagui/get-token": "2.7.6",
@@ -79,9 +79,9 @@
     "tamagui": "2.7.6"
   },
   "devDependencies": {
-    "@multiplatform.one/config": "7.49.1",
-    "@multiplatform.one/storybook": "7.49.1",
-    "@multiplatform.one/test-utils": "7.49.1",
+    "@multiplatform.one/config": "7.49.3",
+    "@multiplatform.one/storybook": "7.49.3",
+    "@multiplatform.one/test-utils": "7.49.3",
     "@tamagui/build": "2.7.6",
     "@tamagui/config": "2.7.6",
     "@tamagui/vite-plugin": "2.7.6",

package/src/FloatingPanel/useFloatingPanel.frames.spec.tsx

@@ -0,0 +1,79 @@
+/**
+ * FZ-7904: the open effect's two frames (setVisible(true)) and the scroll
+ * lock's frame (window.scrollTo) used to be requested and never cancelled, so
+ * a close or unmount inside them still showed the panel or scrolled the page,
+ * and after teardown they threw into a deleted window.
+ */
+import { holdAnimationFrames } from "@multiplatform.one/test-utils/frames";
+import { renderWithProviders } from "@multiplatform.one/test-utils";
+import { act, cleanup } from "@testing-library/react";
+import { afterEach, describe, expect, it, vi } from "vitest";
+import { useFloatingPanel } from "./useFloatingPanel";
+
+afterEach(() => {
+  cleanup();
+  vi.restoreAllMocks();
+  vi.unstubAllGlobals();
+});
+
+function Harness({ open }: { open: boolean }) {
+  const panel = useFloatingPanel({ open, onOpenChange: () => {}, useAutoUpdate: false });
+  return (
+    <>
+      <div ref={panel.setReferenceRef} />
+      {panel.mounted && (
+        <div
+          data-testid="panel"
+          data-visible={String(panel.visible)}
+          ref={panel.refs.setFloating}
+        />
+      )}
+    </>
+  );
+}
+
+function openPanel() {
+  const frames = holdAnimationFrames();
+  const result = renderWithProviders(<Harness open={false} />);
+  result.rerender(<Harness open />);
+  expect(result.getByTestId("panel")).toBeTruthy();
+  return { ...result, frames };
+}
+
+function flushFrames(frames: { flush: () => void }) {
+  act(() => {
+    frames.flush();
+    frames.flush();
+  });
+}
+
+describe("useFloatingPanel frames (FZ-7904)", () => {
+  it("shows the panel two frames after it opens", () => {
+    const h = openPanel();
+    flushFrames(h.frames);
+    expect(h.getByTestId("panel").dataset.visible).toBe("true");
+  });
+
+  it("a close inside the open frames never shows the panel", () => {
+    const h = openPanel();
+    h.rerender(<Harness open={false} />);
+    flushFrames(h.frames);
+    expect(h.getByTestId("panel").dataset.visible).toBe("false");
+  });
+
+  it("a close cancels the scroll lock's frame", () => {
+    const scrollTo = vi.spyOn(window, "scrollTo").mockImplementation(() => {});
+    const h = openPanel();
+    h.rerender(<Harness open={false} />);
+    scrollTo.mockClear();
+    flushFrames(h.frames);
+    expect(scrollTo).not.toHaveBeenCalled();
+  });
+
+  it("an unmount leaves no frame behind", () => {
+    const h = openPanel();
+    expect(h.frames.pending).toBeGreaterThan(0);
+    h.unmount();
+    expect(h.frames.pending).toBe(0);
+  });
+});

package/src/FloatingPanel/useFloatingPanel.ts

@@ -336,7 +336,18 @@ export function useFloatingPanel({
     if (open) {
       if (needsSetupRef.current) setupForOpen();
       needsSetupRef.current = true;
-      requestAnimationFrame(() => requestAnimationFrame(() => setVisible(true)));
+      let inner = 0;
+      const outer = requestAnimationFrame(() => {
+        // The outer frame can outlive the document, and with it the global.
+        if (typeof requestAnimationFrame === "function") {
+          inner = requestAnimationFrame(() => setVisible(true));
+        }
+      });
+      return () => {
+        if (typeof cancelAnimationFrame !== "function") return;
+        cancelAnimationFrame(outer);
+        cancelAnimationFrame(inner);
+      };
     } else {
       setVisible(false);
       setArrowUp(false);
@@ -473,12 +484,13 @@ export function useFloatingPanel({
     };
 
     window.scrollTo(0, scrollY);
-    requestAnimationFrame(() => window.scrollTo(0, scrollY));
+    const restoreScroll = requestAnimationFrame(() => window.scrollTo(0, scrollY));
 
     document.addEventListener("wheel", preventScroll, { passive: false, capture: true });
     document.addEventListener("keydown", preventKeyScroll, { capture: true });
     document.addEventListener("touchmove", preventTouchScroll, { passive: false, capture: true });
     return () => {
+      if (typeof cancelAnimationFrame === "function") cancelAnimationFrame(restoreScroll);
       document.removeEventListener("wheel", preventScroll, { capture: true });
       document.removeEventListener("keydown", preventKeyScroll, { capture: true });
       document.removeEventListener("touchmove", preventTouchScroll, { capture: true });

package/src/shared/animationFrames.spec.ts

@@ -0,0 +1,47 @@
+/**
+ * @multiplatform.one/test-utils frames (FZ-7904). test-utils has no runner of
+ * its own; forms loads its setup, so the frames are pinned here.
+ */
+import { createAnimationFrames } from "@multiplatform.one/test-utils/frames";
+import { afterEach, describe, expect, it, vi } from "vitest";
+
+afterEach(() => {
+  vi.useRealTimers();
+});
+
+describe("test-utils animation frames", () => {
+  it("runs a frame on the next timer turn with a timestamp", () => {
+    vi.useFakeTimers();
+    const frames = createAnimationFrames();
+    const callback = vi.fn();
+    frames.request(callback);
+    expect(callback).not.toHaveBeenCalled();
+    vi.advanceTimersByTime(0);
+    expect(callback).toHaveBeenCalledTimes(1);
+    expect(typeof callback.mock.calls[0][0]).toBe("number");
+  });
+
+  it("cancels a frame by its handle", () => {
+    vi.useFakeTimers();
+    const frames = createAnimationFrames();
+    const callback = vi.fn();
+    frames.cancel(frames.request(callback));
+    vi.advanceTimersByTime(10);
+    expect(callback).not.toHaveBeenCalled();
+    expect(vi.getTimerCount()).toBe(0);
+  });
+
+  it("close cancels pending frames and refuses new ones", () => {
+    vi.useFakeTimers();
+    const frames = createAnimationFrames();
+    const pending = vi.fn();
+    frames.request(pending);
+    frames.close();
+    const late = vi.fn();
+    frames.request(late);
+    expect(vi.getTimerCount()).toBe(0);
+    vi.advanceTimersByTime(10);
+    expect(pending).not.toHaveBeenCalled();
+    expect(late).not.toHaveBeenCalled();
+  });
+});

package/src/shared/focusManagement.spec.tsx

@@ -1,20 +1,23 @@
-import type { ReactNode } from "react";
+import { StrictMode, type ReactNode } from "react";
 import { Preset, type Animation } from "@multiplatform.one/theme";
 import { TestProviders } from "@multiplatform.one/test-utils";
+import { holdAnimationFrames } from "@multiplatform.one/test-utils/frames";
 import { act, cleanup, renderHook } from "@testing-library/react";
 import { afterEach, describe, expect, it, vi } from "vitest";
 import { useReturnFocusOnClose, useSheetModalFocus } from "./focusManagement";
 
 afterEach(() => {
   cleanup();
+  vi.unstubAllGlobals();
   vi.useRealTimers();
   document.body.replaceChildren();
 });
 
 for (const mode of ["floating", "sheet"] as const) {
   describe(`${mode} close focus`, () => {
-    function setup() {
+    function setup({ holdFrames = false, strict = false } = {}) {
       vi.useFakeTimers();
+      const frames = holdFrames ? holdAnimationFrames() : null;
       const trigger = document.createElement("button");
       const frame = document.createElement("div");
       const item = document.createElement("button");
@@ -25,11 +28,19 @@ for (const mode of ["floating", "sheet"] as const) {
       const skipReturnFocusRef = { current: false };
       const frameRef = { current: frame };
       let animation: Animation = "quick";
-      const Wrapper = ({ children }: { children: ReactNode }) => (
+      const Providers = ({ children }: { children: ReactNode }) => (
         <TestProviders>
           <Preset overrides={{ animation }}>{children}</Preset>
         </TestProviders>
       );
+      const Wrapper = ({ children }: { children: ReactNode }) =>
+        strict ? (
+          <StrictMode>
+            <Providers>{children}</Providers>
+          </StrictMode>
+        ) : (
+          <Providers>{children}</Providers>
+        );
       const hook = renderHook(
         ({ open }) => {
           if (mode === "sheet") useSheetModalFocus(open, frameRef, skipReturnFocusRef);
@@ -39,6 +50,7 @@ for (const mode of ["floating", "sheet"] as const) {
       );
       return {
         ...hook,
+        frames,
         trigger,
         item,
         outside,
@@ -111,5 +123,42 @@ for (const mode of ["floating", "sheet"] as const) {
       await act(() => vi.advanceTimersByTimeAsync(400));
       expect(document.activeElement).not.toBe(h.trigger);
     });
+
+    // FZ-7904: the close retries used to drop their frame and timer ids.
+    it("cancels a close's retries when the overlay reopens", () => {
+      const h = setup({ holdFrames: true });
+      const frames = h.frames!.pending;
+      const timers = vi.getTimerCount();
+      h.rerender({ open: false });
+      h.rerender({ open: true });
+      expect(h.frames!.pending).toBe(frames);
+      expect(vi.getTimerCount()).toBe(timers);
+    });
+
+    it("leaves no frame or timer behind once it unmounts, and still restores", async () => {
+      const h = setup({ holdFrames: true });
+      h.trigger.blur();
+      h.rerender({ open: false });
+      h.unmount();
+      expect(h.frames!.pending).toBe(0);
+      expect(vi.getTimerCount()).toBe(0);
+      await Promise.resolve();
+      expect(document.activeElement).toBe(h.trigger);
+    });
+
+    it("a StrictMode remount on open does not pull focus back out", async () => {
+      const h = setup({ strict: true });
+      h.item.focus();
+      await Promise.resolve();
+      await act(() => vi.advanceTimersByTimeAsync(400));
+      expect(document.activeElement).toBe(h.item);
+    });
+
+    it("does not throw when its frame outlives the requestAnimationFrame global", () => {
+      const h = setup({ holdFrames: true });
+      h.rerender({ open: false });
+      vi.stubGlobal("requestAnimationFrame", undefined);
+      expect(() => h.frames!.flush()).not.toThrow();
+    });
   });
 }

package/src/shared/focusManagement.ts

@@ -37,6 +37,7 @@
 import { useEffect, useRef, type RefObject } from "react";
 import { isWeb, useDialogContext } from "tamagui";
 import { wasKeyboardFocus, useResolvedKnobs, motionHideDelayMs } from "@multiplatform.one/theme";
+import { useRestoreRetries } from "./restoreRetries";
 
 const FOCUSABLE =
   'a[href], button:not([disabled]), input:not([disabled]), select:not([disabled]), textarea:not([disabled]), [tabindex]:not([tabindex="-1"])';
@@ -67,15 +68,14 @@ function useCaptureOnOpen(open: boolean) {
   return { prevRef, generationRef };
 }
 
-function restoreLater(
+function focusRestore(
   prevRef: RefObject<HTMLElement | null>,
   generationRef: RefObject<number>,
-  delayMs: number,
   insideRef?: RefObject<HTMLElement | null>,
   skipReturnFocusRef?: RefObject<boolean>,
 ) {
   const generation = generationRef.current;
-  const restore = () => {
+  return () => {
     // Fires from the unmount path, so the document can be gone by now (a test
     // environment torn down inside the retry window). `isConnected` stays
     // stale-true on a detached node, so it does not cover this.
@@ -90,10 +90,6 @@ function restoreLater(
       } as FocusOptions);
     }
   };
-  // Exit animations unmount / park the overlay a few frames later; retry
-  // after the typical exit window. All calls are idempotent.
-  requestAnimationFrame(() => requestAnimationFrame(restore));
-  setTimeout(restore, delayMs);
 }
 
 /**
@@ -111,17 +107,18 @@ export function useReturnFocusOnClose(
   const { knobProps } = useResolvedKnobs();
   const restoreDelayMsRef = useRef(0);
   restoreDelayMsRef.current = motionHideDelayMs(knobProps.motion.scrim.transition);
+  const retries = useRestoreRetries();
   useEffect(() => {
     if (!canUseDom() || !open) return;
+    retries.cancel();
+    // Exit animations unmount / park the overlay a few frames later; retry
+    // after the typical exit window. All calls are idempotent.
     return () =>
-      restoreLater(
-        prevRef,
-        generationRef,
+      retries.schedule(
+        focusRestore(prevRef, generationRef, insideRef, skipReturnFocusRef),
         restoreDelayMsRef.current,
-        insideRef,
-        skipReturnFocusRef,
       );
-  }, [open, prevRef, generationRef, skipReturnFocusRef, insideRef]);
+  }, [open, prevRef, generationRef, skipReturnFocusRef, insideRef, retries]);
 }
 
 /**
@@ -139,19 +136,17 @@ export function useSheetModalFocus(
   const { knobProps } = useResolvedKnobs();
   const restoreDelayMsRef = useRef(0);
   restoreDelayMsRef.current = motionHideDelayMs(knobProps.motion.scrim.transition);
+  const retries = useRestoreRetries();
   useEffect(() => {
     if (!canUseDom() || !open) return;
+    retries.cancel();
+    const restoreLater = () =>
+      retries.schedule(
+        focusRestore(prevRef, generationRef, frameRef, skipReturnFocusRef),
+        restoreDelayMsRef.current,
+      );
     const frame = frameRef.current;
-    if (!frame || typeof frame.addEventListener !== "function") {
-      return () =>
-        restoreLater(
-          prevRef,
-          generationRef,
-          restoreDelayMsRef.current,
-          frameRef,
-          skipReturnFocusRef,
-        );
-    }
+    if (!frame || typeof frame.addEventListener !== "function") return restoreLater;
 
     // Focus moves in once the sheet has mounted its frame (spring start).
     const focusIn = () => {
@@ -193,9 +188,9 @@ export function useSheetModalFocus(
       cancelAnimationFrame(raf);
       cancelAnimationFrame(innerRaf);
       frame.removeEventListener("keydown", onKeyDown);
-      restoreLater(prevRef, generationRef, restoreDelayMsRef.current, frameRef, skipReturnFocusRef);
+      restoreLater();
     };
-  }, [open, frameRef, prevRef, generationRef, skipReturnFocusRef]);
+  }, [open, frameRef, prevRef, generationRef, skipReturnFocusRef, retries]);
 }
 
 const DIALOG_SHOW_FOCUS_EVENT = "mp.dialogShowFocus";

package/src/shared/restoreRetries.ts

@@ -0,0 +1,87 @@
+/**
+ * The retries an overlay runs to return focus after it closes: after two
+ * frames, then after the exit window (FZ-7904). The handles are kept, so a
+ * new schedule or a reopen cancels the old retries instead of stacking them,
+ * and an unmount leaves no frame or timer behind: the restore it would have
+ * run happens once, in a microtask, unless the component mounted again
+ * (StrictMode's simulated unmount).
+ */
+
+import { useEffect, useRef } from "react";
+
+export interface RestoreRetries {
+  schedule: (restore: () => void, delayMs: number) => void;
+  cancel: () => void;
+}
+
+const hasFrames = () => typeof requestAnimationFrame === "function";
+
+export function useRestoreRetries(): RestoreRetries {
+  const mountedRef = useRef(false);
+  const retriesRef = useRef<(RestoreRetries & { unmount: () => void }) | null>(null);
+  if (!retriesRef.current) {
+    let outer = 0;
+    let inner = 0;
+    let timer: ReturnType<typeof setTimeout> | undefined;
+    let pending: (() => void) | null = null;
+    const restoreOnceUnmounted = (restore: () => void) => {
+      queueMicrotask(() => {
+        if (!mountedRef.current) restore();
+      });
+    };
+    const cancel = () => {
+      if (typeof cancelAnimationFrame === "function") {
+        if (outer) cancelAnimationFrame(outer);
+        if (inner) cancelAnimationFrame(inner);
+      }
+      if (timer !== undefined) clearTimeout(timer);
+      outer = 0;
+      inner = 0;
+      timer = undefined;
+      pending = null;
+    };
+    retriesRef.current = {
+      cancel,
+      schedule(restore, delayMs) {
+        cancel();
+        if (!mountedRef.current) {
+          restoreOnceUnmounted(restore);
+          return;
+        }
+        pending = restore;
+        if (hasFrames()) {
+          outer = requestAnimationFrame(() => {
+            outer = 0;
+            // The outer frame can outlive the document (a test window torn
+            // down between the two frames), and with it the global.
+            if (!hasFrames()) return;
+            inner = requestAnimationFrame(() => {
+              inner = 0;
+              if (timer === undefined) pending = null;
+              restore();
+            });
+          });
+        }
+        timer = setTimeout(() => {
+          timer = undefined;
+          if (!outer && !inner) pending = null;
+          restore();
+        }, delayMs);
+      },
+      unmount() {
+        const restore = pending;
+        cancel();
+        if (restore) restoreOnceUnmounted(restore);
+      },
+    };
+  }
+  const retries = retriesRef.current;
+  useEffect(() => {
+    mountedRef.current = true;
+    return () => {
+      mountedRef.current = false;
+      retries.unmount();
+    };
+  }, [retries]);
+  return retries;
+}

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

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

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;;;;;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"}
+{"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;AA0D1D;;;;;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,QAkB1C;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,QA6DxC;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/restoreRetries.d.ts

@@ -0,0 +1,14 @@
+/**
+ * The retries an overlay runs to return focus after it closes: after two
+ * frames, then after the exit window (FZ-7904). The handles are kept, so a
+ * new schedule or a reopen cancels the old retries instead of stacking them,
+ * and an unmount leaves no frame or timer behind: the restore it would have
+ * run happens once, in a microtask, unless the component mounted again
+ * (StrictMode's simulated unmount).
+ */
+export interface RestoreRetries {
+    schedule: (restore: () => void, delayMs: number) => void;
+    cancel: () => void;
+}
+export declare function useRestoreRetries(): RestoreRetries;
+//# sourceMappingURL=restoreRetries.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"restoreRetries.d.ts","sourceRoot":"","sources":["../../src/shared/restoreRetries.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,CAAC,OAAO,EAAE,MAAM,IAAI,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACzD,MAAM,EAAE,MAAM,IAAI,CAAC;CACpB;AAID,wBAAgB,iBAAiB,IAAI,cAAc,CAoElD"}