perf(ui): stage history overscan restoration

2026-08-26 00:42:36 +08:00
parent 1c3c26f2bf
commit 1dfa3aee2f
3 changed files with 139 additions and 1 deletions
@@ -0,0 +1,34 @@
+import * as React from 'react';
+
+export const useActivationOverscan = (enabled: boolean, normalOverscan: number): number => {
+    const [recoveryStep, setRecoveryStep] = React.useState(0);
+
+    React.useEffect(() => {
+        if (!enabled) {
+            setRecoveryStep(0);
+            return;
+        }
+
+        let halfOverscanFrame: number | undefined;
+        const paintOpportunityFrame = window.requestAnimationFrame(() => {
+            halfOverscanFrame = window.requestAnimationFrame(() => {
+                React.startTransition(() => setRecoveryStep(1));
+            });
+        });
+        return () => {
+            window.cancelAnimationFrame(paintOpportunityFrame);
+            if (halfOverscanFrame !== undefined) window.cancelAnimationFrame(halfOverscanFrame);
+        };
+    }, [enabled]);
+
+    React.useEffect(() => {
+        if (!enabled || recoveryStep !== 1) return;
+        const normalOverscanFrame = window.requestAnimationFrame(() => {
+            React.startTransition(() => setRecoveryStep(2));
+        });
+        return () => window.cancelAnimationFrame(normalOverscanFrame);
+    }, [enabled, recoveryStep]);
+
+    if (!enabled || recoveryStep >= 2) return normalOverscan;
+    return recoveryStep === 0 ? 0 : Math.ceil(normalOverscan / 2);
+};