Update to focus-trap@8.0.0 with breaking changes (#1801)

* Update to focus-trap@8.0.0 with breaking changes
* Fix tests

Author: stefcameron

.changeset/focus-trap-8-upgrade.md

@@ -0,0 +1,5 @@
+---
+"focus-trap-react": major
+---
+
+**BREAKING:** Updated [focus-trap](https://github.com/focus-trap/focus-trap/blob/master/CHANGELOG.md#800) dependency to v8.0.0. The breaking change is that `onPostActivate()` is now correctly called after the initial focus node is focused (it was previously called before due to a bug with the initial focus delay). See the focus-trap changelog for more details.

package-lock.json

@@ -108,7 +108,7 @@
     "typescript": "^5.9.3"
   },
   "dependencies": {
-    "focus-trap": "^7.8.0",
+    "focus-trap": "^8.0.0",
     "tabbable": "^6.4.0"
   },
   "peerDependencies": {

package.json

@@ -381,13 +381,16 @@ describe('FocusTrap', () => {
 
       await pause(3);
 
+      // `checkCanFocusTrap` not yet resolved so no post-activate
       expect(onActivate).toHaveBeenCalled();
       expect(onPostActivate).not.toHaveBeenCalled();
 
       await pause(6);
 
+      // `checkCanFocusTrap` should have resolved now, but post-activate
+      //  is still delayed to the next frame (trap behavior)
       expect(onActivate).toHaveBeenCalled();
-      expect(onPostActivate).toHaveBeenCalled();
+      await waitFor(() => expect(onPostActivate).toHaveBeenCalled());
     });
 
     it('Does not call onPostDeactivate() until checkCanReturnFocus() has completed', async () => {
@@ -456,7 +459,9 @@ describe('FocusTrap', () => {
       fireEvent.click(activateTrapButton);
 
       expect(onActivate).toHaveBeenCalled();
-      expect(onPostActivate).toHaveBeenCalled();
+
+      // post-activate is always delayed to next frame by the trap
+      await waitFor(() => expect(onPostActivate).toHaveBeenCalled());
     });
 
     it('Will call onPostDeactivate() even if checkCanReturnFocus() is undefined', async () => {