Add TypeScript declarations for the performance global

React Native installs a `performance` global (setUpPerformance) along with
the Performance, PerformanceEntry, PerformanceMark and PerformanceMeasure
globals, and the Flow libdefs declare it, but src/types/globals.d.ts did not.
Projects compiled without lib "dom" got "Cannot find name 'performance'".

Declare these globals based on the Flow implementation in
src/private/webapis/performance, and add type tests.

Fixes #58610

Author: Cedric921

packages/react-native/__typetests__/globals.tsx

@@ -15,6 +15,49 @@ const clonedValue: {nested: {value: number}} = structuredClone({
 });
 console.log(domExceptionCode, dataCloneErrorCode, clonedValue.nested.value);
 
+function testPerformance() {
+    const start: number = performance.now();
+    const timeOrigin: number = performance.timeOrigin;
+
+    const mark: PerformanceMark = performance.mark('start', {
+        detail: {foo: 'bar'},
+        startTime: start,
+    });
+    const markDetail: unknown = mark.detail;
+    performance.mark('end');
+
+    const measure: PerformanceMeasure = performance.measure('duration', 'start', 'end');
+    const measureDetail: unknown = measure.detail;
+    performance.measure('withOptions', {start: 'start', end: 'end', detail: 1});
+    performance.measure('withDuration', {start, duration: 10});
+
+    const entries: ReadonlyArray<PerformanceEntry> = performance.getEntries();
+    const marks: ReadonlyArray<PerformanceEntry> = performance.getEntriesByType('mark');
+    const named: ReadonlyArray<PerformanceEntry> = performance.getEntriesByName('start', 'mark');
+    const entry = entries[0];
+    const name: string = entry.name;
+    const entryType: PerformanceEntryType = entry.entryType;
+    const startTime: number = entry.startTime;
+    const duration: number = entry.duration;
+    const json: {name: string; entryType: PerformanceEntryType; startTime: number; duration: number} = entry.toJSON();
+
+    performance.clearMarks();
+    performance.clearMarks('start');
+    performance.clearMeasures();
+    performance.clearMeasures('duration');
+
+    const customMark: PerformanceMark = new PerformanceMark('custom', {startTime: 1});
+    const isPerformance: boolean = performance instanceof Performance;
+
+    console.log(timeOrigin, markDetail, measureDetail, marks, named, name, startTime, duration, json, customMark, isPerformance);
+
+    // @ts-expect-error
+    performance.mark();
+
+    // @ts-expect-error
+    performance.getEntriesByType('wrong-type');
+}
+
 function testInterval() {
     clearInterval(null);
     clearInterval(undefined);

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

@@ -120,6 +120,104 @@ declare global {
 
   function structuredClone<T>(value: T): T;
 
+  type PerformanceEntryType =
+    'mark' | 'measure' | 'event' | 'longtask' | 'resource';
+
+  /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceEntry) */
+  interface PerformanceEntry {
+    readonly name: string;
+    readonly entryType: PerformanceEntryType;
+    readonly startTime: number;
+    readonly duration: number;
+    toJSON(): {
+      name: string;
+      entryType: PerformanceEntryType;
+      startTime: number;
+      duration: number;
+    };
+  }
+
+  var PerformanceEntry: {
+    prototype: PerformanceEntry;
+    new (): PerformanceEntry;
+  };
+
+  interface PerformanceMarkOptions {
+    detail?: unknown;
+    startTime?: number;
+  }
+
+  /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceMark) */
+  interface PerformanceMark extends PerformanceEntry {
+    readonly detail: unknown;
+  }
+
+  var PerformanceMark: {
+    prototype: PerformanceMark;
+    new (
+      markName: string,
+      markOptions?: PerformanceMarkOptions,
+    ): PerformanceMark;
+  };
+
+  /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceMeasure) */
+  interface PerformanceMeasure extends PerformanceEntry {
+    readonly detail: unknown;
+  }
+
+  var PerformanceMeasure: {
+    prototype: PerformanceMeasure;
+    new (): PerformanceMeasure;
+  };
+
+  /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Performance) */
+  interface Performance {
+    readonly timeOrigin: number;
+    now(): number;
+    mark(
+      markName: string,
+      markOptions?: PerformanceMarkOptions,
+    ): PerformanceMark;
+    clearMarks(markName?: string): void;
+    measure(
+      measureName: string,
+      startMarkOrOptions?:
+        | string
+        | {
+            detail?: unknown;
+            start?: number | string;
+            duration?: number;
+          }
+        | {
+            detail?: unknown;
+            start?: number | string;
+            end?: number | string;
+          }
+        | {
+            detail?: unknown;
+            duration?: number | string;
+            end?: number | string;
+          },
+      endMark?: string,
+    ): PerformanceMeasure;
+    clearMeasures(measureName?: string): void;
+    getEntries(): ReadonlyArray<PerformanceEntry>;
+    getEntriesByType(
+      entryType: PerformanceEntryType,
+    ): ReadonlyArray<PerformanceEntry>;
+    getEntriesByName(
+      entryName: string,
+      entryType?: PerformanceEntryType,
+    ): ReadonlyArray<PerformanceEntry>;
+  }
+
+  var Performance: {
+    prototype: Performance;
+    new (): Performance;
+  };
+
+  var performance: Performance;
+
   /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/DOMRectReadOnly) */
   interface DOMRectReadOnly {
     /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/DOMRectReadOnly/bottom) */