Add TypeScript declarations for requestIdleCallback and cancelIdleCallback (#57545)

Summary:
`requestIdleCallback` and `cancelIdleCallback` exist at runtime on both architectures. The New Architecture has a native implementation since 0.75 in #44759 (landed as abfadc6, closing #44636). Legacy architecture has a JS-timer-based implementation in `JSTimers` since 2016 (18394fb, follow-up to #5052). Support for the `options` param was added in cf51aee. The API is documented at https://reactnative.dev/docs/global-requestIdleCallback

Flow libdefs already declare both functions in`flow/global.js`

The public TypeScript declarations never included them.
React Native projects compile without `lib: ["dom"]`, so TypeScript users get no declaration

This PR adds the declarations to the `Timer Functions` region of `src/types/globals.d.ts`, based on the Flow signatures

## Changelog:

[GENERAL] [ADDED] - Add TypeScript declarations for `requestIdleCallback` and `cancelIdleCallback`

Pull Request resolved: #57545

Test Plan:
Added `testRequestIdleCallback()` to `packages/react-native/__typetests__/globals.tsx`

```
yarn test-generated-typescript
yarn test-typescript-legacy
yarn lint
yarn prettier
```

Reviewed By: javache

Differential Revision: D112540741

Pulled By: fabriziocucci

fbshipit-source-id: 77f26b4729ecd6cd6b723da026d45730cee22995

Author: Critteros

packages/react-native/__typetests__/globals.tsx

@@ -137,6 +137,30 @@ function testRequestAnimationFrame(){
     );
 }
 
+function testRequestIdleCallback() {
+    cancelIdleCallback(null);
+    cancelIdleCallback(undefined);
+
+    let handle = requestIdleCallback(deadline => {
+        const didTimeout: boolean = deadline.didTimeout;
+        const remaining: number = deadline.timeRemaining();
+        console.log(didTimeout, remaining);
+    });
+    cancelIdleCallback(handle);
+
+    handle = requestIdleCallback(noop, { timeout: 100 });
+    cancelIdleCallback(handle);
+
+    handle = requestIdleCallback(noop, {});
+    cancelIdleCallback(handle);
+
+    // @ts-expect-error
+    requestIdleCallback(noop, { timeout: 'wrong-type' });
+
+    // @ts-expect-error
+    cancelIdleCallback('wrong-type');
+}
+
 const fetchCopy: WindowOrWorkerGlobalScope['fetch'] = fetch;
 
 const myHeaders = new Headers();

packages/react-native/src/types/globals.d.ts

@@ -125,6 +125,15 @@ declare global {
   function cancelAnimationFrame(handle: number | null | undefined): void;
   function requestAnimationFrame(callback: (time: number) => void): number;
 
+  function requestIdleCallback(
+    callback: (deadline: {
+      didTimeout: boolean;
+      timeRemaining: () => number;
+    }) => void,
+    options?: {timeout?: number | undefined},
+  ): number;
+  function cancelIdleCallback(handle: number | null | undefined): void;
+
   function fetchBundle(
     bundleId: number,
     callback: (error?: Error | null) => void,